Calculate surcharge information based on payment method ID and transaction amount. Learn about surcharge rates, compliance requirements, and implementation details for credit card transactions.
Calculate surcharge information based on a given payment_method_id and transaction amount. This is useful for informing customers of any additional fees associated with using certain payment methods, typically credit cards.
Key Features
Detailed Surcharge Rates
Provides detailed surcharge rates and amounts for credit card transactions.
Merchant Account Verification
Confirms whether the surcharge feature is enabled for the merchant account.
Compliance Simplified
Simplifies compliance with surcharge regulations and card network rules.
Implementation Details
Usage Notes
Surcharging Enabled: This calculation is only relevant if the merchant has surcharging enabled.
Credit Cards Only: Surcharges are typically applied to credit card transactions, not debit cards.
Customer Communication: Clearly communicate surcharge amounts to customers before completing the transaction.
Response Structure
| Code | Response | Reason |
|---|---|---|
| 200 | Success | Returns surcharge information |
| 400 | Bad Request | Invalid input data or total amount. |
| 401 | Unauthorized | Authentication failed. |
| 404 | Not Found | A payment method does not exist. |
| 500 | Internal Server Error | An unexpected error occurred on the server. |
Important Considerations
Regulatory Compliance: Ensure surcharging practices comply with local laws and card network regulations.
Fee Disclosure: Be transparent with customers about any additional fees.
Non-Surcharged Methods: Debit cards and other payment methods may not incur a surcharge.