Trust Gateway
Home/Guides/API
TRUST GATEWAY GUIDE

Handling Payment API Errors Without Duplicating Customer Charges

Plan for timeouts, invalid requests, repeated submissions, and status lookups in a payment integration.

Validate before the request

Check the amount, customer order identifier, and required fields on your server before calling a payment API. Keep credentials server-side. Treat validation errors differently from network failures: a malformed request can be corrected immediately, while a timeout leaves the outcome uncertain until you query the existing order.

Do not create blindly after a timeout

If your server did not receive a response, the gateway might still have created the first request. Use your stored order reference or a documented idempotency mechanism to determine whether to retry. Where a lookup endpoint exists, query status before issuing another payment request. This prevents confusing a customer with several active links for one purchase.

Make failure states useful

Show the customer a clear pending or retry message without exposing internal errors. Log request IDs and safe diagnostic details for your team. Test invalid input, temporary server failure, slow responses, and duplicate button clicks. A resilient payment flow protects both the customer experience and your reconciliation process.

Questions about your own setup? Review the developer documentation or open your merchant dashboard.