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
Payments API features endpoints for retrieving and updating a merchant's surcharge settings:
- Enabled: If true, the merchant may apply surchages to their transactions.
- 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
{
"data": {
"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
{
"data": {
"enabled": true,
"accepts_in_person_payments": true,
"taxable": true,
"rate": 0.0234,
"average_processing_rate": 0.0285,
"rate_limiter": "merchant_rate"
}
}Calculate Surcharge
Payments API features an endpoint that calculates a maximum surcharge amount and rate for a given amount and an optional payment method. It should be used prior to calling a sale endpoint; the integrating software is responsible for calculating the tax on the surcharge and calculating the total amount used in the sale endpoint call. The payment method on the request is optional to support use cases in which the card cannot be collected prior to the call to a sale endpoint (i.e., a device sale). 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 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 (optional): If the card payment method is provided, the card type will be checked; if it is not a credit card, the transaction 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
country_rate, 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
merchant_rate, the surcharge rate is the minimum of the merchant's country rate and their merchant-defined rate (if defined). - If rate limiter is
average_processing_rate, the surcharge rate is the minimum of the merchant's country rate and their average processing rate (if available).
The response also includes a limiting_factor property that describes the factor preventing the rate from being higher. If more than one limiting factor applies, only the first is returned.
- unknown
- processor_not_supported: Only supported by Stripe and Worldpay Express.
- surcharges_not_enabled: The merchant has not enabled surcharging.
- card_type_not_supported: 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
card_type_not_supported. - country_rate: The merchant's country rate was used.
- merchant_rate: The merchant-defined rate was used.
- processing_rate: 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 /ps/surcharge/calculate
{
"transaction_amount": 100.00,
"payment_method" : {
"card": {
"card_number": "4242424242424242",
"expiration_year": 2035,
"expiration_month": 12,
"cvv": "123",
"billing_postal_code": "30330",
"cardholder_name": "John Doe"
}
}
}Response Object
{
"transaction_amount": 103.00,
"surcharge_amount": 2.34,
"surcharge_rate": 0.0234,
"limiting_factor": "merchant_rate"
}Sale Endpoints
An optional surcharge amount may be provided when creating a new sale transaction via the following endpoints:
A non-zero surcharge amount is allowed only if all of the following conditions are true:
- The merchant has enabled surcharges.
- The given payment method is a card.
- On non-device sales, the transaction represents a completed sale (i.e., the
captureproperty is "completed_sale", not "auth_until_capture", or "tip_adjustment"). - Partial approvals are not allowed (i.e.,
allow_partial_approvalsis "false"). - 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 $2.34 (2.34% of the amount), yielding a total transaction amount of $102.34:
{
"payment_method" : {
"card": {
"card_number": "4242424242424242",
"expiration_year": 2035,
"expiration_month": 12,
"cvv": "123",
"billing_postal_code": "30330",
"cardholder_name": "John Doe"
}
},
"options": {
"card": {
"capture": "completed_sale",
"sale_type": "card_not_present",
"allow_partial_approvals": false,
"avs": "fail_on_postal_code_no_match"
}
},
"surcharge_amount": 2.34,
"amount": 102.34,
"currency": "usd",
}The calculate surcharge endpoint should be used to determine surcharge eligibility and amount.
Device Sales
When executing a sale transaction (transact/device/sale) the calculate surcharge endpoint should be used prior without passing in a payment_method to retrieve the recommended surcharge amount. With a non-zero surcharge amount using a device, the device will request the cardholder to confirm the payment, including surcharge amount following card collection.
Updated 15 days ago
