Payout Payee ID Type

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

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 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.

bankId	bankCode	bankName
1	0001	Banco de Chile
2	0009	Banco Internacional
3	0012	Banco Estado
4	0014	Scotiabank Chile
5	0016	Banco de crédito e inversiones (BCI)
6	0027	Banco Corpbanca (不再支持)
7	0028	Banco Bice (不再支持)
8	0031	HSBC Bank Chile
9	0037	Banco Santander Chile
10	0039	Itaú Corpbanca
11	0049	Banco Security
12	0051	Banco Falabella
13	0053	Banco Ripley
14	0054	Rabobank Chile (不再支持)
15	0055	Banco Consorcio
16	0056	Banco Penta (不再支持)
17	0057	Banco Paris (不再支持)
18	0059	Banco BTG Pactual Chile (不再支持)
19	0504	Banco Bilbao Vizcaya Argentaria Chile (BBVA)
20	0672	Coopeuch
21	729	Caja los Andes
22	730	Tenpo
23	732	Los Andes
24	875	Mercado Pago

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

值	说明
1	RUT

Payin PayType Enum

Value	Description	状态
220	聚合收银台	启用，聚合收银台支持以下所有类型
221	WEB_PAY	暂未启用，需申请使用
223	MACH	暂未启用，需申请使用
224	CHEK	暂未启用，需申请使用
225	MULTICAJA_TRANSFER	暂未启用，需申请使用
226	PAGO46	暂未启用，需申请使用
227	HITES	暂未启用，需申请使用
229	MULTICAJA_EFECTIVO	暂未启用，需申请使用
231	SERVI_FACIL	暂未启用，需申请使用
238	BANK_TRANSFER	暂未启用，需申请使用
239	SERVIPAG	暂未启用，需申请使用

代收支付方式说明

目前聚合收银台支持以下代收方式

• Webpay：Webpay是智利最常见的在线支付平台之一。它由Transbank运营，允许消费者使用信用卡、借记卡或银行转账来支付在线购物和其他服务。
• Khipu：Khipu是智利一家受欢迎的支付平台，提供快速、安全的银行转账服务。它通过与智利各大银行合作，使用户可以使用自己的银行账户直接进行支付。
• Mach：Mach是智利一家数字支付服务提供商，允许用户通过智能手机进行支付。用户可以用信用卡或借记卡充值Mach账户，并在多个商家和在线平台使用这些资金进行 购物和支付。
• Chek：Chek是智利一种预付卡支付方式。用户可以购买Chek卡，并在参与Chek支付的商家使用该卡进行支付，类似于预付卡或礼品卡。
• Multicaja Transfer：Multicaja Transfer是智利一种在线转账服务，允许用户使用智利的不同银行账户之间进行资金转移。
• Pago46：Pago46是智利的一种在线支付服务，专为移动设备和数字交易而设计。它提供多种支付方式，包括信用卡、借记卡和现金支付。
• Hites：Hites是智利一家零售公司，提供自己的支付服务。客户可以通过Hites卡或其他方式在Hites零售店进行支付。
• Fpay：Fpay是智利的一种数字支付服务，允许用户使用智能手机进行支付。它涵盖多种支付方式，包括信用卡、借记卡和其他电子支付方式。

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