Payout Payee ID Type
| idType Value | Description |
|---|---|
| 1 | RUT |
TIP
The RUT must be the RUT corresponding to the bank's collection account, otherwise the payment will fail. (RUN for individuals is RUT).
RUT/RUN supports the following formats, where X is a number and K is a check digit.
XX.XXX.XXX-K, XXXXXXXX-K, XXXXXXXXK, X.XXX.XXX-K, XXXXXXX-K, XXXXXXXK,
- We will perform format verification and validity verification on RUT, and the channel will verify the authenticity of RUT.
- Format verification and validity verification will return the verification results simultaneously. Orders that fail the verification will be directly rejected.
- Authenticity verification will be verified by the bank after the order is submitted to the bank system. Failure to pass the verification will result in payment failure.
Payout Account Type
| accountType Value | Description |
|---|---|
| 1 | Corriente |
| 2 | Vista/Cuenta RUT |
| 3 | Ahorro |
TIP
Vista/Cuenta RUT This account type is only available in Banco Estado bank.
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 |
|---|---|
| GATEWAY_TIMEOUT | Payment gateway timeout |
| SYSTEM_EXCEPTION | Upstream system exception |
| PAYMENT_TRANSACTION_EXCEPTION | Payment transaction exception |
| BANK_NAME_ERROR | Wrong bank name |
| BANK_CODE_ERROR | Bank coding error |
| BANK_ACCOUNT_ERROR | Wrong bank account number |
| PAYMENT_OFFSET | Payment offset |
| SUCCESS | Success |
| UNKNOWN_ERROR | Unknown error |
| NUMBER_AND_DOCUMENTS_NOT_MATCH | Account number and ID do not match |
| DOCUMENTS_INVALID | The document number is invalid |
| BLOCKED_ACCOUNTS | Blocked accounts |
| ACCOUNT_TYPE_NOT_VALID_FOR_TARGET_BANK | The account type is invalid for the target bank |
| EACH_PAYMENT_LIMIT_EXCEEDED | The payment amount exceeds the maximum limit for a single payment |
| DAILY_PAYMENT_LIMIT_EXCEEDED | The payment amount exceeds the maximum daily cumulative payment limit |
| MONTHLY_PAYMENT_LIMIT_EXCEEDED | The payment amount exceeds the maximum monthly cumulative payment limit |
| YEARLY_PAYMENT_LIMIT_EXCEEDED | The payment amount exceeds the maximum annual cumulative payment limit |
| AMOUNT_TOO_SMALL | The payment limit was too low and was rejected by the bank |
| ACCOUNTING_BILL_ERROR | Error paying bill |
| PHONE_NUMBER_INVALID | Invalid mobile number |
| PAYMENT_REJECTED_BY_BANK | Payment transaction declined by bank |
| RUT_INVALID | Invalid RUT |
| COMPLIANCE_REJECT | Payment declined due to compliance |
| BANK_ACCOUNT_INVALID | Invalid bank account number |
| TARGET_BANK_UNAVAILABLE | The target bank is temporarily unavailable |
Payin Payer ID Type
| idType Value | Description |
|---|---|
| 1 | RUT |
Payin PayType Enum
| payType Value | Description | Status |
|---|---|---|
| 220 | Cashier Payment url | Available，All of the following types are supported |
| 221 | WEB_PAY | Not available, need to apply |
| 223 | MACH | Not available, need to apply |
| 224 | CHEK | Not available, need to apply |
| 225 | MULTICAJA_TRANSFER | Not available, need to apply |
| 226 | PAGO46 | Not available, need to apply |
| 227 | HITES | Not available, need to apply |
| 229 | MULTICAJA_EFECTIVO | Not available, need to apply |
| 231 | SERVI_FACIL | Not available, need to apply |
| 238 | BANK_TRANSFER | Not available, need to apply |
| 239 | SERVIPAG | Not available, need to apply |
PayIn method description
Currently Cashier Payment url supports the following payment methods
- Webpay：Webpay is one of the most common online payment platforms in Chile. Operated by Transbank, it allows consumers to pay for online purchases and other services using credit cards, debit cards or bank transfers.
- Khipu：Khipu is a popular payment platform in Chile that provides fast and secure bank transfer services. It works with major banks in Chile to allow users to make payments directly using their bank accounts.
- Mach：Mach is a Chilean digital payment service provider that allows users to make payments via smartphone. Users can top up their Mach accounts with credit or debit cards and use these funds to make purchases and payments at multiple merchants and online platforms.
- Chek：Chek is a prepaid card payment method in Chile. Users can purchase a Chek card and use it to pay at participating merchants, similar to a prepaid card or gift card.
- Multicaja Transfer：Multicaja Transfer is a Chilean online money transfer service that allows users to transfer funds between different bank accounts in Chile.
- Pago46：Pago46 is a Chilean online payment service designed for mobile devices and digital transactions. It offers a variety of payment methods, including credit cards, debit cards, and cash payments.
- Hites：Hites is a Chilean retail company that provides its own payment service. Customers can pay in Hites retail stores using Hites cards or other methods.
- Fpay：Fpay is a digital payment service in Chile that allows users to make payments using their smartphones. It covers a variety of payment methods, including credit cards, debit cards and other electronic payment methods.
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_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_accountNo_CardNumber_Invalidate | Bank CardNumber 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 |
Params_accountName_Required | Please pass the recipient account name | Some countries |
Params_accountName_Maximum<64>characters | The recipient account name must not exceed 64 characters | Some countries |
Params_accountName_not_contain_Chinese | The recipient account name must not contain Chinese | Some countries |
Params_CPF_accountNo_Invalid | The recipient account number in CPF format is invalid | Brazil |
Params_idType_Required | ID type must be passed | Some countries |
Params_idType_Invalid | Invalid ID type | Some countries |
Params_idCard_Required | ID number must be passed | Some countries |
Params_idCard_CPF_Invalid | Invalid CPF ID number | Brazil |
Params_realName_Required | The name of the payee must be passed | Some countries |
Params_realName_Maximum<64>characters | The name of the payee must not exceed 64 characters | Some countries |
Params_realName_not_contain_Chinese | The name of the payee must not contain Chinese | Some countries |
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 |