Skip to main content

​
Overview

Payment Processing in TradeMaster Transactions enables you to configure multiple payment methods, process customer transactions, and manage financial operations across your box offices and online sales channels.
TMT supports various payment methods including credit cards, debit cards, cash, bank transfers, and digital wallets, with multi-currency capabilities.

​
Payment Methods

Payment methods define how customers can pay for tickets:

Credit Cards

Visa, Mastercard, American Express, and other credit card networks

Debit Cards

Direct debit from customer bank accounts

Cash

Physical currency for in-person transactions

Bank Transfers

Direct bank-to-bank transfers

Digital Wallets

PayPal, Apple Pay, Google Pay, and other digital payment services

Cryptocurrency

Bitcoin, Ethereum, and other digital currencies

​
Accessing Payment Methods

1

Navigate to Payment Methods

From the main menu, go to Configuración > Métodos de Pago
2

View Payment Methods Table

The table displays all configured payment methods with their status and currency
3

Search and Filter

Use the search bar to find specific payment methods by name or currency

​
Creating a Payment Method

1

Click Create Payment Method

Click the Crear Método de Pago button in the top-right corner
2

Enter Basic Information

Fill in the payment method details:
{
  name: "Credit Card - Visa",
  type: "Credit Card",
  currency: "USD",
  status: true
}
3

Configure Payment Gateway

Set up integration details:
  • API credentials
  • Merchant ID
  • Gateway endpoint
  • Security certificates
4

Link Custody Account

Associate the payment method with a custody account for fund management:
custody_account: {
  account_id: "custody_123",
  account_name: "Main Operating Account",
  bank: "Bank Name",
  account_number: "****1234"
}
5

Set Transaction Fees

Configure any processing fees or percentages
6

Activate and Save

Set status to active and save the payment method
Ensure all payment gateway credentials are stored securely. Never share API keys or merchant credentials via unsecured channels.

​
Payment Method Configuration

​
Required Fields

FieldTypeRequiredDescription
NameTextYesDisplay name for the payment method
TypeDropdownYesCategory (Credit Card, Cash, Transfer, etc.)
CurrencyDropdownYesSupported currency (USD, MXN, EUR, etc.)
StatusBooleanYesActive/Inactive
Custody AccountReferenceYesLinked bank account for deposits
Processing FeePercentageNoTransaction fee percentage
Gateway DetailsJSONConditionalRequired for online payment methods

​
Payment Method Types

{
  name: "Visa/Mastercard",
  type: "Credit Card",
  method: "card",
  gateway: {
    provider: "Stripe",
    public_key: "pk_live_...",
    secret_key: "sk_live_...",
    webhook_secret: "whsec_..."
  },
  currency: "USD",
  processing_fee: 2.9 // percentage
}

​
Payment Methods Table

The payment methods table provides an overview of all configured payment options:

​
Table Columns

  • Displays payment method name with icon
  • Shows payment type below the name (Credit Card, Cash, etc.)
<IconWallet size="2rem" />
<Box>
  <Typography variant="h6">{method.name}</Typography>
  <Typography variant="subtitle2">{method.type}</Typography>
</Box>
Shows the currency supported by this payment method (USD, MXN, EUR, etc.)
Visual indicator showing if the payment method is active:
  • 🟢 Green dot: Active and available for use
  • 🔴 Red dot: Inactive and not available
  • View Details: Click the eye icon to open payment method details
  • Edit: Modify payment method configuration
  • Deactivate: Temporarily disable the payment method

​
Assigning Payment Methods to Offices

Box offices need assigned payment methods to process transactions:

​
Adding Payment Methods to an Office

1

Open Office Configuration

Navigate to the office you want to configure
2

Select Payment Methods

From the office form, choose which payment methods to enable:
// Office payment methods configuration
payments_methods: [
  {
    payment_method_id: "pm_123",
    name: "Credit Card - Visa",
    currency: "USD",
    custody_account: "custody_456",
    method: "card",
    percentage: 0 // Office-specific fee adjustment
  },
  {
    payment_method_id: "pm_124",
    name: "Cash - USD",
    currency: "USD",
    custody_account: "custody_456",
    method: "cash",
    percentage: 0
  }
]
3

Configure Office-Specific Settings

Set any office-specific fees or adjustments
4

Save Configuration

Save the office configuration to activate the payment methods
Different offices can have different payment methods. For example, virtual offices might only accept online payments, while physical offices can accept cash.

​
Processing Transactions

​
Order Payment Flow

1

Calculate Order Total

System calculates the total based on selected tickets:
{
  subtotal: 300.00,
  service_fee: 15.00,
  processing_fee: 9.14, // 2.9% of total
  total: 324.14
}
2

Select Payment Method

Ticket seller or customer selects available payment method
3

Process Payment

System processes payment based on method type:
  • Card: Real-time gateway authorization
  • Cash: Manual confirmation and receipt generation
  • Transfer: Generate reference and await confirmation
4

Create Order Record

On successful payment, create order with payment details:
{
  order_id: "ORD-20240312-001",
  amount: 324.14,
  payment_method: "Credit Card - Visa",
  payment_status: "completed",
  transaction_id: "txn_abc123",
  date: {
    created: "2024-03-12T15:30:00"
  }
}
5

Generate Receipt and Tickets

Issue receipt and tickets with QR codes to customer

​
Transaction Status

Completed

Payment successfully processed and confirmed

Pending

Awaiting payment confirmation (common for bank transfers)

Failed

Payment declined or failed to process

Refunded

Payment returned to customer

​
Orders Management

View and manage all payment transactions:

​
Orders Table

// Order data structure
{
  id: "order_123",
  event_name: "Rock Concert 2024",
  office_name: "Main Box Office",
  amount: 324.14,
  status: true, // Active order
  date: {
    created: "2024-03-12T15:30:00"
  },
  payment_method: "Credit Card - Visa",
  tickets: [
    { ticket_id: "A-12", price: 150.00 },
    { ticket_id: "A-13", price: 150.00 }
  ]
}

​
Viewing Order Details

1

Navigate to Orders

Go to Ventas > Órdenes from the main menu
2

Search for Order

Use the search bar to find orders by event name, amount, or date
3

Click Order

Click the eye icon or anywhere on the row to view order details
4

View Transaction Information

See complete payment details including:
  • Payment method used
  • Transaction ID
  • Processing fees
  • Customer information
  • Ticket details
  • Receipt and invoice

​
Payment Reconciliation

Reconcile payments with bank deposits and financial records:

​
Custody Accounts

Custody accounts track where payment funds are deposited: 
{
  custody_account_id: "custody_123",
  name: "Main Operating Account",
  bank: "Bank Name",
  account_number: "****1234",
  currency: "USD",
  balance: 125600.00,
  transactions: [
    {
      date: "2024-03-12",
      description: "Ticket Sales - Concert",
      amount: 324.14,
      order_id: "ORD-20240312-001"
    }
  ]
}

​
Reconciliation Process

1

Export Transaction Report

Generate a report of all transactions for a date range
2

Compare with Bank Statement

Match reported transactions with bank deposits
3

Identify Discrepancies

Flag any missing or mismatched transactions
4

Resolve Issues

Investigate and resolve any discrepancies found
TMT includes a reconciliation module that helps automate the comparison between system records and bank statements.

​
Refund Processing

​
Issuing Refunds

1

Locate Original Order

Find the order that needs to be refunded
2

Verify Refund Eligibility

Check event policy and refund window
3

Initiate Refund

Click the refund button and enter refund details:
  • Full or partial refund
  • Reason for refund
  • Refund amount
4

Process Payment Reversal

System processes refund through original payment method:
  • Card: Automatic gateway reversal
  • Cash: Generate refund voucher for customer
  • Transfer: Initiate return bank transfer
5

Cancel Tickets

Tickets are marked as cancelled and returned to inventory
Refunds typically take 5-10 business days to appear in customer accounts. Processing times vary by payment method and banking institution.

​
Multi-Currency Support

TMT supports transactions in multiple currencies:

​
Currency Configuration

// Supported currencies
const currencies = [
  { code: "USD", symbol: "$", name: "US Dollar" },
  { code: "MXN", symbol: "$", name: "Mexican Peso" },
  { code: "EUR", symbol: "€", name: "Euro" },
  { code: "GBP", symbol: "£", name: "British Pound" },
  { code: "CAD", symbol: "$", name: "Canadian Dollar" }
];

​
Currency Exchange

When processing payments in different currencies, exchange rates are applied automatically based on current market rates.

​
Security Best Practices

PCI Compliance

Ensure all card payment processing meets PCI DSS standards

Encryption

All payment data is encrypted in transit and at rest

Tokenization

Card numbers are tokenized and never stored in plain text

Secure Credentials

API keys and secrets are stored in secure environment variables

Access Control

Limit payment method configuration to authorized users only

Audit Logs

All payment transactions are logged for audit purposes

​
Reporting and Analytics

​
Payment Reports

Generate comprehensive payment reports:
Total sales by payment method for a specific day
{
  date: "2024-03-12",
  total_sales: 12450.00,
  by_method: [
    { method: "Credit Card", amount: 8900.00, count: 67 },
    { method: "Cash", amount: 2350.00, count: 28 },
    { method: "Bank Transfer", amount: 1200.00, count: 5 }
  ]
}
Total revenue for a specific event broken down by payment method
Sales totals for each box office showing payment method usage
Summary of all processing fees charged by payment gateways

​
Troubleshooting

  1. Verify the payment method status is “Active”
  2. Check that the payment method is assigned to the office
  3. Confirm the currency matches the ticket price currency
  4. Ensure the payment gateway credentials are valid
  1. Verify customer has sufficient funds
  2. Check for correct card details entry
  3. Ensure payment gateway is operational
  4. Review fraud detection rules that might be blocking the transaction
  5. Try an alternative payment method
  1. Verify original transaction was completed
  2. Check that refund window hasn’t expired
  3. Confirm payment gateway supports refunds
  4. Ensure custody account has sufficient balance
  5. Review refund policy restrictions
  1. Check that payment method supports the ticket currency
  2. Verify exchange rate configuration is correct
  3. Ensure custody account accepts the currency
  4. Update payment method currency settings if needed

Office Operations

Configure payment methods for each box office

Ticket Sales

Process ticket sales using configured payment methods

Build docs developers (and LLMs) love

Get started for freeTalk to us