Skip to main content

Error Handling

Handle payment errors gracefully in your integration.

Common Errors​

Payment Rejected​

Cause: Customer rejected transaction
State: -1 (Failed)
Action: Allow customer to retry

Insufficient Balance​

Cause: Customer doesn't have enough tokens
State: -1 (Failed)
Action: Show clear error message

Network Error​

Cause: Network connectivity issue
State: Varies
Action: Retry transaction

Wrong Network​

Cause: Customer on wrong blockchain
State: Payment blocked
Action: Prompt network switch

Error Handling Best Practices​

  1. Clear Messages: Provide user-friendly error messages
  2. Retry Options: Allow customers to retry
  3. Support Contact: Provide support contact info
  4. Logging: Log errors for debugging

Next Steps​

Handling errors? Check Troubleshooting →