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 pre-tax subtotal 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:
- Enabled: If true, the merchant may apply surchages to their payments.
- Accepts In Person Payments: If true, indicates that the merchant does in-person retail transactions. This value is used for reporting and compliance audits. The integrating software must capture this information as part of the process to enable credit card surcharges.
- Taxable: If true, indicates that the merchant will apply taxes to surcharges. While this flag is stored by PaySimple, the integrating software is responsible for determining the applicable tax rate and calculating the tax amount. The surcharge amount should be taxed at the same rate as the line items to which the surcharge is applied.
- Rate: The merchant-defined custom surcharge rate. This value may not exceed the maximum surcharge rate allowed for the merchant's country. This value is used when calculating the surcharge for a payment if Rate Limiter is set to
merchant_rate. - Average Processing Rate: The average of processing costs incurred by the merchant. PaySimple maintains a rolling 12-month average of a merchant's processing rate. This value is used when calculating the surcharge for a payment if Rate Limiter is set to
average_processing_rate. - Rate Limiter: Determines whether the merchant's
country_rate(default),merchant_rate, oraverage_processing_rateis used to calculate surcharges for eligible transactions.
Retrieving Surcharge Settings
Request
GET /ps/surcharge/settingsResponse Object
{
"enabled": true,
"accepts_in_person_payments": true,
"taxable": true,
"rate": 0.0234,
"average_processing_rate": 0.0285,
"rate_limiter": "merchant_rate"
}Updating Surcharge Settings
Request Object
POST /ps/surcharge/settings
{
"enabled": true,
"accepts_in_person_payments": true,
"taxable": true,
"rate": 0.0234,
"rate_limiter": "merchant_rate"
}Response Object
{
"enabled": true,
"accepts_in_person_payments": true,
"taxable": true,
"rate": 0.0234,
"average_processing_rate": 0.0285,
"rate_limiter": "merchant_rate"
}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; the integrating software is responsible for calculating the tax on the surcharge and calculating the total amount 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 amount passed in to the transaction amount should be the pre-tax subtotal of the order or invoice in question.
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 payment is not eligible for surcharges and the rate is 0.
- Surcharge Settings: If the merchant has not enabled surcharges, the payment is not eligible for surcharges and the rate is 0.
- Card Type: If the given customer account is not a credit card, the payment is not eligible for surcharges and the rate is 0.
- Rate Limiter:
- If rate limiter is not defined, the surcharge rate is the minimum of the merchant's country rate and their merchant-defined rate (if defined).
- If rate limiter is
CountryRate, the surcharge rate is the merchant's country rate. The country rate is 3.0% for the United States and 2.4% for Canada. Other countries are not supported. - If rate limiter is
MerchantRate, the surcharge rate is the minimum of the merchant's country rate and their merchant-defined rate (if defined). - If rate limiter is
AverageProcessingRate, the surcharge rate is the minimum of the merchant's country rate and their average processing rate (if available).
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 was used.
- MerchantRate: The merchant-defined rate was used.
- ProcessingRate: The merchant's average processing rate was used.
Failure to adhere to the calculated surcharge amount may cause legal or compliance issues.
Request Object
POST /v4/surcharge/calculate
{
"TransactionAmount": 100.00,
"AccountId": 7377983
}Response Object
{
"TransactionAmount": 102.34,
"SurchargeAmount": 2.34,
"SurchargeRate": 0.0234,
"LimitingFactor": "MerchantRate"
}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 credit card.
- The surcharge amount is less than or equal to 3% of the payment 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 $2.34 (2.34% of the amount), yielding a total transaction amount of $102.34:
{
"Amount" : 102.34,
"AccountId" : 7377983,
"SurchargeAmount": 2.34
}The calculate surcharge endpoint should be used to determine surcharge eligibility and amount.
Updated 14 days ago
