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
- Provides detailed surcharge rates and amounts for credit card transactions.
- Confirms whether the surcharge feature is enabled for the merchant account.
- Simplifies compliance with surcharge regulations.
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.