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.