Error Codes

Lesspay uses conventional HTTP response codes along with business-level error codes in the JSON response to indicate the success or failure of an API request.

2xx status codes denote that the requested operation was performed successfully.

4xx status codes denote a client error, often due to invalid parameters or authentication issues.

5xx status codes denote a server-side error with Lesspay's systems.

HTTP Status Codes

Status Code	Meaning
`200`	OK: Request successful
`400`	Bad Request: Invalid request format or parameters
`401`	Unauthorized: Invalid or missing API Key/Signature
`403`	Forbidden: You are not authorized to access the requested resource
`404`	Not Found: The requested resource does not exist
`500`	Internal Server Error: A problem occurred on our server. Try again later

Pay Out Business Error Codes (30000-30079)

In the JSON response body, the code field indicates the business result. The msg field provides a human-readable explanation.

General Errors

Code	Description	Suggestion
`0`	Success	Request was successful.
`30000`	Invalid Parameter	Check required fields and data formats.

Parameter Validation Errors (30001-30009)

Code	Description	Suggestion
`30001`	Unsupported Currency	Only PHP, INR, IDR are supported for payout.
`30002`	Amount Mismatch	`target_amount` does not equal the sum of detail amounts.
`30003`	Review Rejected	Order rejected by internal operations review.
`30004`	Invalid Beneficiary Type	Must be `business` or `individual`.
`30005`	Invalid Country Code	Must be 2-character ISO 3166-1 alpha-2 code.
`30006`	Invalid Bank Account	Check account number format.
`30007`	Duplicate Detail ID	`mch_order_id` within the batch must be unique.
`30008`	Invalid Transaction Type	Must be `payout`.
`30009`	Invalid Amount Format	Amount must be a valid positive number string.

Idempotency Errors (30010-30019)

Code	Description	Suggestion
`30010`	Idempotency Conflict	Same `request_id` with different parameters.
`30011`	Duplicate Request ID	`request_id` already exists.

Query Errors (30020-30029)

Code	Description	Suggestion
`30020`	Order Not Found	Verify `pay_order_id` or `request_id`.
`30021`	Detail Not Found	Verify `mch_order_id`.

Channel Errors (30030-30039)

Code	Description	Suggestion
`30030`	Channel Insufficient Balance	Contact operations to top up channel funds.
`30031`	Channel Error	Upstream payment channel returned an error.
`30032`	Channel Timeout	Retry the request or check later.
`30033`	Channel Not Configured	Payout channel is not set up for this app.

Merchant/App Status Errors (30040-30049)

Code	Description	Suggestion
`30040`	Merchant Status Abnormal	Contact support.
`30041`	App Status Abnormal	App may be disabled. Contact support.
`30042`	Payout Not Enabled	Enable payout in merchant settings.
`30043`	Payment Method Not Configured	Configure the payment method for this app.

Signature Errors (30050-30059)

Code	Description	Suggestion
`30050`	Signature Error	Check signature algorithm and key.
`30051`	Signature Verification Failed	Re-generate the signature.
`30052`	Timestamp Expired	Use current timestamp and re-sign.
`30053`	Invalid Signature Type	Check `sign_type` parameter.

Order Status Errors (30060-30069)

Code	Description	Suggestion
`30060`	Order Status Not Allow	Current order status does not permit this action.
`30061`	Order Already Processing	Wait for the order to complete.
`30062`	Order Already Completed	Cannot modify a completed order.

Limit Errors (30070-30079)

Code	Description	Suggestion
`30070`	Single Amount Exceed Limit	Lower the single transaction amount.
`30071`	Daily Amount Exceed Limit	Wait for the next day or contact support.
`30072`	Detail Count Exceed Limit	Reduce the number of details in the batch.
`30073`	Amount Too Small	Increase the transaction amount.

HTTP Status Codes#

Pay Out Business Error Codes (30000-30079)#

General Errors#

Parameter Validation Errors (30001-30009)#

Idempotency Errors (30010-30019)#

Query Errors (30020-30029)#

Channel Errors (30030-30039)#

Merchant/App Status Errors (30040-30049)#

Signature Errors (30050-30059)#

Order Status Errors (30060-30069)#

Limit Errors (30070-30079)#