Response Codes
Waffo API response format:codeof"0"indicates success- On failure,
codeis an error code string (e.g.,"A0003","E0001") - The response field is named
msg(notmessage)
Error Code Categories
For the full error code list, see Error Code Reference.
Handling E0001 Unknown Status
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
paymentRequestIdto 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.).