Errors

Errors return JSON. message is always present. code is present only where listed. Validation errors also include fields.

HTTP	When	Example
400	Validation failed	`{"message": "Validation failed.", "fields": ["amount: Field required"]}`
400	Bad signature. Coming soonThis becomes `401`.	`{"message": "Invalid signature"}`
400	Missing `x-signature`, or `timestamp` outside 5 minutes	`{"message": "Invalid or expired timestamp"}`
400	Fractional JPY, or insufficient balance	`{"message": "JPY amounts must be whole yen"}`
401	Missing or unknown API key	`{"message": "Invalid API key"}`
403	Your IP is not allow-listed	`{"message": "Invalid IP address."}`
404	Transaction or KYC record not found	`{"message": "Transaction not found"}`
502	Payment network error	`{"message": "...", "code": "KYC_NOT_REGISTERED"}`

502 codes:

Code	Meaning
`KYC_NOT_REGISTERED`	This JPY player has not been registered. Call `POST /kyc-register`.
`GATEWAY_NOT_ENABLED`	The KYC channel is not enabled on your account.
`KYC_NOT_SUPPORTED`	KYC is not available for this request.

Treat any 5xx or timeout on deposit or withdraw as unknown. Query POST /transactions with your referenceId before you create the order again. A retry can create a second order.