Skip to main content

Response Codes

Waffo API response format:
  • code of "0" indicates success
  • On failure, code is an error code string (e.g., "A0003", "E0001")
  • The response field is named msg (not message)

Error Code Categories

For the full error code list, see Error Code Reference.

Handling E0001 Unknown Status

This is the most critical exception scenario. When you encounter a network timeout, connection interruption, or the server returns E0001, the payment status is unknown.

Principles

  • Do not assume failure: a network timeout does not mean the payment failed
  • Do not automatically close the order: the payment may have already completed on the channel side
  • Do not create a new order: use the original paymentRequestId to query

Error Types in the SDK

The SDK has only two error types. WaffoUnknownStatusError/Exception means the payment may have succeeded, while WaffoError/Exception indicates a client-side error (configuration, signature, etc.).

SDK Error Codes

Handling Flow

Code Example