Credit Card Surcharges
Overview
A credit card surcharge (hereafter surcharge) is an additional fee added to a credit card transaction. This fee is designed to offset the processing costs that merchants incur when accepting credit card payments.
The surcharge is typically calculated as a percentage of the transaction amount and is added to the total amount at the point of sale. It's important to note that surcharging is different from convenience fees or service charges, as it specifically relates to the payment method chosen by the customer.
Note that the merchant is solely responsible for utilizing the credit card surcharge feature in compliance with the PaySimple Terms of Service and Acceptable Use Policy ; and all applicable Visa, MasterCard, American Express, and Discover rules; and all applicable laws and regulations.
Rules and Regulations
Surcharging is subject to various regulations and restrictions that vary by location and card network.
Legal Requirements
- Geographic Restrictions: Some jurisdictions prohibit or restrict surcharges. In jurisdictions where surcharges are allowed, clear disclosure to the cardholder is required prior to payment authorization, as well as on receipts.
- Card Network Rules: Visa, Mastercard, American Express, and Discover, have specific guidelines for surcharging.
- Registration Requirements: Merchants may be required to register with card networks before applying surcharges.
Business Rules
- Surcharges may only be applied to payments against cards, not bank accounts or other payment method types.
- Surcharges may only be applied to payments against credit cards, not debit cards, or prepaid cards.
- The surcharge must not exceed the actual cost of processing the credit card transaction
Surcharge Settings
API4 features endpoints for retrieving and updating a merchant's surcharge settings.
Retrieving Surcharge Settings
Request
GET /surcharge/settingsResponse Object
{
"data": {
"enabled": true
}
}Updating Surcharge Settings
Request Object
POST /surcharge/settings
{
"enabled": false
}Response Object
{
"data": {
"enabled": false
}
}Calculate Surcharge
API4 features an endpoint that calculates the maximum surcharge amount and rate for the given nominal amount and customer account. It should be used prior to calling the create payment endpoint, and the returned surcharge amount and total transaction amount should be used in the create payment endpoint call. While this endpoint assists callers in ensuring compliance with legal and card network regulations, the merchant is ultimately responsible.
The returned surcharge rate is determined by several factors, applied in the following order:
- Card Processor: If the merchant's card processor does not support surcharges, the transaction is not eligible for surcharges and the rate is 0.
- Surcharge Settings: If the merchant has not enabled surcharges, the transaction is not eligible for surcharges and the rate is 0.
- Card Type: If the given customer account is not a credit card, the transaction is not eligible for surcharges and the rate is 0.
- Merchant Country: If a merchant is in the United States, its maximum surcharge rate is 3.0%; if the merchant is in Canada, it's maximum surcharge rate is 2.4%. Other countries are not supported.
- Processing Rate: The surcharge rate cannot exceed the merchant's processing rate.
If a payment is eligible for surcharges, the surcharge rate is the minimum of the merchant's country rate and the merchant's processing rate.
The response also includes a LimitingFactor property that describes the factor preventing the rate from being higher. If more than one limiting factor applies, only the first is returned.
- Unknown
- ProcessorNotSupported: Only supported by Stripe and Worldpay Express.
- SurchargesNotEnabled: The merchant has not enabled surcharging.
- CardTypeNotSupported: The provided card is not a credit card, possibly either a debit or pre-paid card. Note: it is possible that the provided card is a credit card, but it is unknown to the BIN lookup. This situation will be treated as
CardTypeNotSupported. - CountryRate: The merchant's country rate will be used.
- ProcessingRate: This is only applicable to merchants processing with Worldpay Express.
Failure to adhere to the calculated surcharge amount may cause legal or compliance issues.
Request Object
POST /surcharge/calculate
{
"TransactionAmount": 100.00,
"AccountId": 7377983
}Response Object
{
"TransactionAmount": 103.00,
"SurchargeAmount": 3.00,
"SurchargeRate": 0.03,
"LimitingFactor": "CountryRate"
}Create Payment
An optional surcharge amount may be provided when creating a new payment via the following endpoint:
A non-zero surcharge amount is allowed only if all of the following conditions are true:
- The merchant has enabled surcharges.
- The given customer account is a card.
- The surcharge amount is less than or equal to 3% of the nominal amount.
Note that the Amount property of sale requests represents the total transaction amount, including the surcharge amount. In the following example, the amount is $100.00, the surcharge amount is $3.00 (3.0% of the amount), yielding a total transaction amount of $103.00:
{
"Amount" : 103.00,
"AccountId" : 7377983,
"SurchargeAmount": 3.00
}The calculate surcharge endpoint should be used to determine surcharge eligibility and amount.
Updated 3 days ago
