Payout Account Type
| Value | Description |
|---|---|
0 | (Corriente) |
1 | (Ahorro) |
Payout Payee ID Type
| Value | Description | Order remarks |
|---|---|---|
| 1 | DNI | 通常为8位数字 |
| 2 | PAS | 通常为7-12 位数字 |
| 3 | CE | 通常为8-20 位数字 |
| 4 | RUC | 通常为 11 位数字 |
代付收款银行账号格式
| 银行名称 | 校验规则 |
|---|---|
| BBVA (Banco Continental) | 18位或20位 EX: 001106660100012345 (18位) EX: 00110666010001234512 (20位) |
| Interbank | 13位 |
| BCP (Banco de Credito) | 活期账户13 储蓄账户:14位 |
| Scotiabank | 10位 Example:0037651234 (10 digits: 3 agency + 7 account) |
| 非四大行 | 使用20位的CCI账号 Example:00219400254640654321 (20 digits) |
Payout Bank List
TIP
The bank support list is subject to the actual support status of the production environment. It is recommended that you call our bank list query interface to confirm the production bank support status before entering the production environment.
| bank_id | bank_code | bank_name |
|---|---|---|
| 1 | BBVA Continental | BBVA Continental |
| 2 | Interbank | Interbank |
| 3 | BCP Banco de Crédito de Perú | BCP Banco de Crédito de Perú |
| 4 | Scotiabank | Scotiabank |
| 5 | Banco Falabella | Banco Falabella |
| 6 | BanBif | BanBif |
| 7 | Banco Santander | Banco Santander |
| 8 | Mi Banco | Mi Banco |
| 9 | Banco de Comercio | Banco de Comercio |
| 10 | Banco Financiero | Banco Financiero |
| 11 | Banco GNB | Banco GNB |
| 12 | Citibank | Citibank |
| 13 | Banco de la Nacion | Banco de la Nacion |
| 14 | CMAC Trujillo | CMAC Trujillo |
| 17 | CMAC Sullana | CMAC Sullana |
| 18 | CMAC Cusco | CMAC Cusco |
| 19 | CMAC Huancayo | CMAC Huancayo |
| 20 | Caja Metropolitana | Caja Metropolitana |
| 21 | Banco Pichincha | Banco Pichincha |
| 22 | Banco Azteca | Banco Azteca |
| 23 | Banco Cencosud | Banco Cencosud |
| 24 | ICBC PERU BANK | ICBC PERU BANK |
| 25 | Caja Maynas | Caja Maynas |
| 26 | Caja Municipal Ica | Caja Municipal Ica |
| 27 | Caja Tacna | Caja Tacna |
| 28 | Banco Ripley | Banco Ripley |
Payout Order Status Enum
| Parameter | Description | Remark |
|---|---|---|
| PROCESSING | PROCESSING | |
| WAITING | Wait for payment | |
| PAYING | Payment Paying | |
| SUCCESS | Payment successful | Order final status |
| FAIL | Payment failed | Order final status |
| CANCEL | Order Canceled | Order final status |
TIP
Note that when processing callbacks or query results from Cashy, the order status should be accurately judged. Only the final result can be considered as a clear success of the collection order.
Payout Order Status Description
| value | description |
|---|---|
| BANK_ACCOUNT_ERROR | Wrong bank account number |
| INVALID_BANK_ACCOUNT | Invalid bank account number |
| INVALID_CCI | Invalid CCI |
| PAYMENT_OFFSET | Payment offset |
| ACCOUNT_NOT_EXIST | Account does not exist |
| CHANNEL_EXCEPTION | Channel exception |
| ID_CARD_ERROR | Wrong user ID number |
| NOT_ACCOUNT_HOLDER | The payee is not the account holder |
| ACCOUNT_CLOSED | The collection account has been canceled/closed |
| NAME_INCOMPLETE | Incomplete User name |
| UNKNOWN_ERROR | Unknown error |
Payin PayType Enum
| Value | Description |
|---|---|
200 | 聚合收银台 |
Payin Order Status Enum
| Parameter | Description | Remark |
|---|---|---|
| PAYING | Wait for payment | |
| SUCCESS | Payment successful | Order final status |
| FAIL | Payment failed | Order final status |
TIP
Note that when processing callbacks or query results from Cashy, the order status should be accurately judged. Only the final result can be considered as a clear success of the collection order.
Common Error Messages
| Value | Description | Countries covered |
|---|---|---|
System_error | System error | All |
System_busy | System busy (Can retry) | All |
System_Maintenance | System Maintenance (Can retry) | All |
MerchantId_is_null | MerchantId is empty | All |
Sign_verify_error | Merchant signature verification error | All |
RequestMethod_not_post | Not a POST request | All |
RequestContentType_not_json | Not an application/json request | All |
RequestBody_is_null | The request body is empty | All |
MerchantId_not_Number | MerchantId is not a number | All |
MerchantId_is_error | Merchant Id error | All |
Request_ip_notWhiteList | Request ip non-whitelist | All |
Params_jsonFormat_error | Request body json format error | All |
Params_xxx_Required | Parameter xxx is required | All |
Params_xxx_error | Parameter xxx error | All |
Params_accountNo_Format_isIncorrect | The bank account number format is incorrect (the length of the bank card number does not match the bank) | Some countries |
Merchant_amount_notEnough | Merchant balance is insufficient | All |
Merchant_not_enabled | Merchant is not enabled | All |
Merchant_not_exist | Merchant does not exist | All |
Params_order_notExist | The platform order number does not exist | All |
Params_mchOrderNo_notExist | The merchant order number does not exist | All |
Params_mchOrderNo_repeat | Duplicate merchant order number | All |
Channel_Maintenance_time | The channel is under maintenance, please contact technical support for testing environment | All |
Tran_risk_intercept | Transaction risk control interception, check whether the amount meets the restriction conditions | All |
Params_accountName_Maximum<40>characters | Payout (beneficiary) payee name is too long | Some countries，MX is 40 characters |
Params_idType_Exists_idCard_CPF_Invalidate | CPF Number Invalidate | BR |
COLLECTION_ACCOUNT_DAY_LIMIT | The number of times the payment card number reaches the daily limit limit | All |
COLLECTION_NAME_DAY_LIMIT | The number of times the payee name reaches the daily limit limit | All |
LIMIT_MIN_AMOUNT | The order amount is less than the minimum amount limit | All |
LIMIT_MAX_AMOUNT | The order amount is higher than the maximum amount limit | All |
BLACK_LIST_USER_LIMIT | The user is on the blacklist | All |
Params_realName_not_contain_Chinese | Account names are not allowed to contain Chinese | All |
Params_accountName_not_contain_Chinese | Account names are not allowed to contain Chinese | All |
Params_accountNo_Clabe_Invalidate | Clabe is invalid | Mexico |
Params_email_format_invalid | The email format is invalid | Mexico |
Params_email_length_exceeds<64>characters | The mailbox length exceeds 64 characters (the mailbox length should be kept below 64 characters) | All |