Skip to content
IN PROGRESS

This site is under active development. The sandbox is coming soon.

This is an independent, unofficial personal learning project. It does not represent any bank, financial institution, or regulator.

Error codes

{
"error": {
"code": "INVALID_REQUEST",
"message": "Missing required parameter amount",
"request_id": "req_01J9Z3K4"
}
}
HTTP Code Description Recommended handling
400 INVALID_REQUEST Invalid request parameters Fix the parameters based on message
401 UNAUTHORIZED Missing or invalid access token Obtain a new token
403 INSUFFICIENT_SCOPE Token lacks the required scope Ask the user for additional consent
404 RESOURCE_NOT_FOUND Resource not found Check the ID and authorized scope
409 IDEMPOTENCY_CONFLICT Idempotency key reused by a different request Use a different idempotency key
429 RATE_LIMITED Rate limit exceeded Back off according to Retry-After
500 INTERNAL_ERROR Server error Record request_id and retry
Code Description
PAYMENT_REJECTED The bank rejected the payment
INSUFFICIENT_FUNDS Insufficient account balance
PAYMENT_NOT_CANCELLABLE Cancellation is not allowed in the current status
ACCOUNT_NOT_PAYABLE The payer account is in an invalid state