Configure whether the billing fees on a payin are credited back to the merchant on full refunds or ACH returns.

By default, the billing fees charged on a payin are returned by the platform when a payin is later refunded or returned. When the payin billing fees are reversed, the amount will be credited back to the originating merchant and included in the billing fee of the refund or ACH return. This configuration is not supported for partial refunds or chargebacks.

In this example, the $3.30 billing fees are recovered from the platform and only the payin amount net the billing fees are debited from the merchant.

Configure billing fee reversal

Reversal of billing fees can be enabled in three ways:

1. The merchant's default configuration, which applies to all full refunds and ACH returns.
2. The payin config, which overrides the merchant's default configuration.
3. The refund request, which overrides both the payin config and the merchant's default configuration.

Merchant configuration

Two fields on the merchant determine if the payin billing fees should always be returned on full refunds and ACH returns. Platforms can set the configuration on the Create merchant request and update the configuration via the Update merchant​ endpoint:

• reverse_payin_billing_fees_on_full_refund_enabled - reverse fees on a full refund
• reverse_payin_billing_fees_on_ach_return_enabled - reverse fees on an ACH return

Payin config

Reversal configuration can also be defined per payin. This allows the platform to dynamically control when the billing fees should be reversed on a per payment configuration. This configuration overrides the merchant's default configuration.

Set the billing_fees_reversal_config object on the Create payin config request:

{
  "amount": 10000,
  "currency_code": "USD",
  "billing_fees_reversal_config": {
    "on_full_refund": true,
    "on_ach_return": false
  }
}

The on_full_refund field determines if the billing fee is credited back to the originating merchant when the payin is refunded for the full amount.

The on_ach_return field determines if the billing fee is credited back to the originating merchant when an ACH return is processed.

Refund request

The reversal can be defined when processing the refund request by setting the payin_billing_fees_reversal_config object. This configuration overrides the configuration defined on the payin config and the merchant's default configuration.

{
  "amount": 10000,
  "currency_code": "USD",
  "payin_billing_fees_reversal_config": {
    "on_full_refund": true
  }
}