Payments APIv1.0.9
Fee Rates
Transaction fee rates by country and plan
Transaction fees are applied based on your WiPay account's country, plan, and the configured fee_structure.
How Fee Structure Works
The fee_structure parameter in your payment request determines how fees are applied:
| Fee Structure | Effect |
|---|---|
customer_pay | The full transaction fee is added to the original total. The customer pays the fee. |
split | Half of the transaction fee is added to the original total. The fee is shared between merchant and customer. |
merchant_absorb | No fee is added. The original total and final total are the same. The fee is deducted from the merchant's settlement. |
Rates by Country
Barbados (BB)
| Plan | Method | Rate |
|---|---|---|
| BASIC FREE | Credit/Debit Card | 3.80% + Tax |
| Any paid plan | Credit/Debit Card | 3.80% + Tax |
Grenada (GD)
| Plan | Method | Rate |
|---|---|---|
| BASIC FREE | Credit/Debit Card | 4.20% + Tax |
| Any paid plan | Credit/Debit Card | 3.80% + Tax |
Guyana (GY)
| Plan | Method | Rate |
|---|---|---|
| BASIC FREE | Credit/Debit Card | 4.20% + Tax |
| Any paid plan | Credit/Debit Card | 3.80% + Tax |
Jamaica (JM)
| Plan | Method | Rate |
|---|---|---|
| BASIC FREE | Credit/Debit Card | 4.20% + GCT |
| Any paid plan | Credit/Debit Card | 3.80% + GCT |
Trinidad & Tobago (TT)
| Plan | Method | Rate |
|---|---|---|
| BASIC FREE | Credit/Debit Card | 3.50% + $0.25 USD |
| Any paid plan | Credit/Debit Card | 3.00% + $0.25 USD |
Notes
-
Paid Plans are monthly (30-day) subscriptions on the WiPay platform. These include:
- Business: Business Plus, Business Premium
- Personal: Personal Premium
-
Dollar-value fees are relative to the transaction currency and are always converted to the currency-equivalent value.
-
GCT applies to Jamaica only. Tax applies to Barbados, Grenada, and Guyana. In each case, the tax value is calculated as 15% of the percentage transaction fee.
Example Calculation
For a TT transaction of $100.00 USD on the BASIC FREE plan (rate of 3.50% + $0.25 USD) with customer_pay:
| Item | Calculation | |
|---|---|---|
| Percentage fee | $100.00 × 3.50% | $3.50 USD |
| Flat fee | Direct flat fee | $0.25 USD |
| Total fee | $3.50 + $0.25 | $3.75 USD |
| Customer debited | $100.00 + $3.75 | $103.75 USD |
| Merchant credited | Original transaction total | $100.00 USD |