Fee Configuration

Setting and managing merchant transaction fees

Fee Configuration

Each merchant has configurable fees for different transaction types. This guide explains how to view and modify fee structures.

Understanding Fees

Fees are charged as a percentage of the transaction amount. Different fee types apply to different operations:

Fee TypeApplies To
Payment FeeStandard payment transactions
Off-ramp FeeConverting crypto to fiat
Swap FeeCurrency exchange transactions
Refund FeeProcessing refunds (fixed USD amount)
OTC Transaction FeeOver-the-counter trading
OTC FX FeeForeign exchange in OTC trades
Payin FeeReceiving funds (deposits)
Payout FeeSending funds (withdrawals/settlements)

Accessing Fee Configuration

  1. Navigate to the merchant detail view
  2. Click the Fees tab
  3. View all configured fees for the merchant
Fee configuration

Fee Display

Each fee shows:

FieldDescription
Fee TypeWhat the fee applies to
PercentageFee as a percentage (e.g., 1.5%)
AmountFor fixed fees, the USD amount

Viewing Current Fees

The fees tab displays:

Payment Fee:           1.50%
Off-ramp Fee:          1.00%
Swap Fee:              0.50%
Refund Fee:            $5.00 USD
OTC Transaction Fee:   0.75%
OTC FX Fee:            0.25%
Default Payin Fee:     0.50%
Default Payout Fee:    0.50%

Editing Fees

To modify a merchant's fees:

  1. Open the merchant's Fees tab
  2. Click the Edit button
  3. Enter the new fee percentages
  4. Click Save
Edit fees

Fee Input Format

  • Enter percentages as decimals (e.g., 1.5 for 1.5%)
  • Enter fixed amounts as numbers (e.g., 5.00 for $5.00 USD)
  • Leave blank or enter 0 for no fee

Fee Calculations

Percentage Fees

Percentage fees are calculated on the transaction amount:

Fee = Transaction Amount × Fee Percentage

Example:
$100 payment × 1.5% = $1.50 fee
Net to merchant = $98.50

Fixed Fees

Fixed fees are charged as a flat amount:

Example:
Refund processed = $5.00 fee charged

Special Considerations

OTC Fees

OTC (over-the-counter) trading has two fee components:

  1. Transaction Fee — Applied to the trade amount
  2. FX Fee — Applied to currency conversion

Both fees may apply to a single trade.

Payin vs Payout Fees

  • Payin Fee — Charged when the merchant receives funds
  • Payout Fee — Charged when funds are sent to the merchant

These are default rates that may be overridden for specific accounts.

Audit Trail

All fee changes are logged:

  • User who made the change
  • Timestamp
  • Previous fee values
  • New fee values

View the audit trail in the merchant's History tab.

Permissions

RoleView FeesEdit Fees
Super AdminYesYes
AdminYesYes
Payment OpsYesNo
Compliance OpsYesNo
CS OpsYesNo
Finance OpsYesYes
View OnlyYesNo

Best Practices

Before Changing Fees

  1. Verify you have authorization to change fees
  2. Check the merchant agreement for fee limits
  3. Consider the impact on the merchant
  4. Document the reason for the change

Fee Changes

  • Fee changes typically apply to future transactions
  • In-progress transactions use the fee at time of initiation
  • Communicate significant changes to the merchant

Auditing

  • Regularly review fee configurations for accuracy
  • Verify fees match merchant agreements
  • Investigate any unexpected fee patterns

Common Scenarios

New Merchant Setup

When onboarding a new merchant:

  1. Review the merchant's agreement for negotiated fees
  2. Enter the agreed fee percentages
  3. Verify all fee types are correctly set

Fee Negotiation

When a merchant negotiates new fees:

  1. Get approval documentation
  2. Update the fee configuration
  3. Note the effective date
  4. Confirm with the merchant

Fee Audit

To audit merchant fees:

  1. Export the fee configuration
  2. Compare to merchant agreement
  3. Identify any discrepancies
  4. Update as needed with documentation

Related Topics