Are payment surcharges supported?
KA-04242
1309
05/19/2025 20:32 PM
1.0
Cybersource supports surcharges on Visa Platform Connect (click to see full list of acquirers), VantivCNP (WorldPay), First Data Global (fdiglobal), and Elavon (elavonamericas) processor gateways only. To process a surcharge, merchants must register their account to support this functionality with their acquiring bank. Please note, failure to register will result in reject responses from the processor.
Use of the surchargeAmount element applies to Visa or Mastercard credit card payments only. Additionally, you are required to notify the card networks and acquirer of your intent to applying surcharges at least 30 days prior to implementing the surcharges.
Below are the API fields that pertain to using Surcharges:
- SOAP: surchargeSign
- REST: no corresponding field
- SCMP: surcharge_sign
- SOAP: surchargeAmount
- REST: orderInformation.amountDetails.surcharge.amount
- SCMP: surcharge_amount
- SOAP: purchaseTotals_grandTotalAmount
- REST: orderInformation.amountDetails.totalAmount
- SCMP: grand_total_amount
Important Note:
Visa Platform Connect Gateway: Merchants who's acquirers utilize Visa Platform Connect must contact their acquirer (see list above) to confirm if they support surcharging and have it enabled at the acquirer level prior to utilizing any surcharging API calls, otherwise they will receive reject responses.
First Data Global/Fiserv Gateway: Merchants must receive prior approval from the processor before assessing a surcharge and must contact FiServ (aka First Data) to be registered with the respective Card Brands for participation in the surcharge program. Additionally, merchants must sign a contract or addendum through FiServ/First Data.
Worldpay (vantivcnp) Gateway: Please reach to your WorldPay Relationship Manager or Customer Service Manager and request surcharging be enabled. There is a flag that WorldPay must enable to allow the surcharge fields to process through. If this flag is not enabled, the transaction will fail.
Was this article helpful?