Error Codes

Overview

This document explains the error codes returned by Veloraya APIs to help developers quickly locate and resolve issues.

Basic Status Codes

Code	Description
200	Request success
500	System error
1000	Unknown error

Parameter Validation Errors (1001)

1001 is used for parameter validation failures. Placeholders: {field} field name, {max} max length, {min} min length.

Code	Description
1001	Parameter error:
1001	{field} must not be empty
1001	{field} length must not exceed
1001	{field} length must be between {min} and {max} characters
1001	{field} format is incorrect
1001	Amount must be greater than 0
1001	Amount cannot have more than 2 decimal places
1001	Unsupported payout account type
1001	Beneficiary blacklist triggered
1001	Beneficiary account must be numeric

Bank/Channel Errors (4004-4011)

Code	Description
4004	Bank timeout
4005	Channel timeout
4006	Beneficiary bank busy
4007	Beneficiary bank under maintenance
4008	Channel under maintenance
4009	Channel rejected transaction
4010	Bank rejected transaction
4011	Beneficiary account amount limit exceeded

Order Module Errors (7001-7016)

Code	Description
7001	Merchant order ID duplicated
7002	Order creation failed
7003	Order status does not support routing
7004	Order rejected
7005	One query condition required
7006	Order not found
7007	Payout bank ID not found
7008	Balance query failed
7009	Beneficiary account invalid
7010	Insufficient balance
7011	Transaction account invalid
7012	Beneficiary account frozen