Unified Response Format

All API responses use a unified format:

{
  "code": 200,
  "msg": "Success",
  "data": {
    // Business data
  }
}

Field	Type	Required	Description
`code`	Integer	Yes	HTTP status code (200 indicates success)
`msg`	String	Yes	Response message
`data`	Object/Array/Null	No	Business data

Error Code Definition

Status Code	Description
200	Request successful
400	Request parameter error
401	Authentication failed (invalid App ID or signature error)
403	Insufficient permissions
404	Resource not found
429	Too many requests (rate limiting triggered)
500	Internal server error
503	Service unavailable (under maintenance)

Response codes

Code	Description
200	Success
400	Failure (required parameter error, etc.)
1001	Failure
1002	System exception
1003	System busy
2000	Merchant payment configuration not found
2001	Currency not available
2002	Insufficient balance
2003	Account frozen
2004	Account abnormal
3000	Duplicate order number
3001	Order not found
3002	Order parameter validation error: currency and payment method mismatch
4001	Payment method business type not supported
4002	Payment method code not supported
4003	Payment method currency not supported
4004	Payment method status unavailable
7002	Channel transaction failed
7013	No matching payment method channel found
7014	Channel status unavailable
7015	Merchant type does not match provider account type
7016	Channel does not support this business type
7017	Channel does not support this currency
7018	Currently outside channel operating hours
7019	Amount exceeds channel or account limit
7020	Exceeds daily account limit
7011	Channel does not support this bank code