Payout Account Type

Value	Description
1	银行账号
2	银行卡号

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	ABBANK	Ngân hàng TMCP An Bình
2	ABC	Ngân hàng TMCP Á Châu
3	ACB	Ngân hàng Thương mại Cổ phần Á Châu
4	AGRIBANK	Ngân hàng Nông nghiệp và Phát triển Nông thôn Việt Nam
5	ANZ	Ngân hàng ANZ Việt Nam
6	BAC A BANK	Ngân hàng TMCP Bắc Á
7	BANK OF INDIA	Ngân hàng Bank of India Việt Nam
8	BAOVIETBANK	Ngân hàng TMCP Tiên Phong
9	BIDV	Ngân hàng Thương mại Cổ phần Đầu tư và Phát triển Việt Nam
10	BOC	Ngân hàng TMCP Trung Quốc
11	BOComm	Ngân hàng TMCP BOCOM
12	BPCE IOM	Ngân hàng BPCE IOM Việt Nam
13	BUSAN BANK	Ngân hàng TNHH MTV Busan Bank Việt Nam
14	CCB	Ngân hàng TMCP Xây dựng Việt Nam
15	CIMB	Ngân hàng CIMB Việt Nam
16	CITIBANK	Ngân hàng Citibank Việt Nam
17	CO-OP BANK	Ngân hàng TMCP Công Thương Việt Nam
18	CTBC Bank	Ngân hàng TNHH MTV CTBC Bank Việt Nam
19	DAEGU BANK	Ngân hàng TNHH MTV Daegu Bank Việt Nam
20	DBS	Ngân hàng DBS Bank (Việt Nam) Limited
21	DEUTSCHE BANK	Ngân hàng Deutsche Bank AG, Chi nhánh Hà Nội
22	DONG A BANK	Ngân hàng TMCP Đông
23	E.SUN BANK	Ngân hàng E.SUN Việt Nam
24	FCB	Ngân hàng TMCP Ngoại Thương Việt Nam
25	GPBANK	Ngân hàng TMCP Dầu khí Toàn Cầu
26	HDBANK	Ngân hàng TMCP Phát triển Thành phố Hồ Chí Minh
27	HLB	Ngân hàng TMCP Hong Leong Việt Nam
28	HNCB	Ngân hàng TMCP Quân đội
29	HSBC	Ngân hàng TNHH MTV HSBC Việt Nam
30	ICBC	Ngân hàng TMCP Công Thương Trung Quốc
31	IVB	Ngân hàng TMCP Công Thương Việt Nam
32	JP MORGAN CHASE	Ngân hàng JP Morgan Chase Bank, Chi nhánh TP.HCM
33	KEB Hana Bank	Ngân hàng TNHH MTV KEB Hana Bank Việt Nam
34	KEB Hana Bank HCM	Ngân hàng TNHH MTV KEB Hana Bank TP.HCM
35	KIENLONGBANK	Ngân hàng TMCP Kiên Long
36	KOOKMIN BANK	Ngân hàng TNHH MTV Kookmin Bank Việt Nam
37	LIENVIETPOSTBANK	Ngân hàng TMCP Bưu điện Liên Việt
38	MALAYAN BANKING BERHAD	Ngân hàng Malayan Banking Berhad Việt Nam
39	MARITIME BANK	Ngân hàng TMCP Hàng Hải Việt Nam
40	MAY BANK	Ngân hàng Maybank Kim Eng Securities (Việt Nam) Limited
41	MB	Ngân hàng TMCP Quân đội
42	MEGA ICBC	Ngân hàng TMCP Công Thương Trung Quốc Việt Nam
43	NAM A BANK	Ngân hàng TMCP Nam
44	NCB	Ngân hàng TMCP Quốc Dân
45	NONG HYUP	Ngân hàng Nông nghiệp và Phát triển Nông thôn Hàn Quốc
46	OCB	Ngân hàng TMCP Phương Đông
47	OCBC	Ngân hàng TNHH MTV OCBC Bank Việt Nam
48	OCEANBANK	Ngân hàng TMCP Đại Dương Việt Nam
49	PGBANK	Ngân hàng TMCP Xăng dầu Petrolimex
50	PVCOMBANK	Ngân hàng TMCP Đại Chúng Việt Nam
51	SACOMBANK	Ngân hàng TMCP Sài Gòn Thương Tín
52	SAIGONBANK	Ngân hàng TMCP Sài Gòn Công Thương
53	SCB	Ngân hàng TMCP Sài Gòn
54	SCSB	Ngân hàng TNHH MTV Shinhan Việt Nam
55	SEABANK	Ngân hàng TMCP Đại Dương
56	SHB	Ngân hàng TMCP Sài Gòn - Hà Nội
57	SHINHAN	Ngân hàng TNHH MTV Shinhan Việt Nam
58	SIAM COMMERCIAL BANK	Ngân hàng TNHH MTV Siam Commercial Bank Việt Nam
59	SINOPAC	Ngân hàng TNHH MTV Sinopac Việt Nam
60	STANDARD CHARTERED	Ngân hàng TNHH MTV Standard Chartered Việt Nam
61	TAIPEI FUBON	Ngân hàng TNHH MTV Taipei Fubon Bank Việt Nam
62	TECHCOMBANK	Ngân hàng Kỹ thương Việt Nam
63	TPBANK	Ngân hàng TMCP Tiên Phong
64	UOB	Ngân hàng UOB Việt Nam
65	VBSP	Ngân hàng Chính sách Xã hội Việt Nam
66	VIB	Ngân hàng TMCP Quốc tế Việt Nam
67	VID	Ngân hàng TMCP Đầu tư và Phát triển Việt Nam
68	VIET A BANK	Ngân hàng TMCP Việt Á
69	VIET BANK	Ngân hàng TMCP Việt Nam Thương Tín
70	VIETCAPITALBANK	Ngân hàng TMCP Việt Nam Thương Tín Đầu tư và Phát triển
71	VIETINBANK	Ngân hàng Thương mại Cổ phần Công thương Việt Nam
72	VNCB	Ngân hàng TMCP Quốc tế Việt Nam
73	VRB	Ngân hàng TMCP Đại Việt
74	WOORI BANK	Ngân hàng TNHH MTV Woori Bank Việt Nam

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
ACCOUNT_NOT_EXIST	Account does not exist
ACCOUNT_FREEZING	Account Freeze
ACCOUNT_CANCEL	Account canceled
ACCOUNT_IN_ANOTHER_CURRENCY	Account in another currency
ACCOUNT_NOT_BELONG_TO	Account does not belong to receiving participant
ACCOUNT_EXCEPTION	Account Status Exception
MCH_NOT_KNOW_PAYMENT	The payee does not acknowledge the payment
MISS_MUST_PAYMENT_INFO	Missing required information to complete payment
ERROR_PAYMENT_TYPE	Wrong payment method
ERROR_OPERATION_TYPE	Wrong operation type
ACCOUNT_TYPE_NOT_APPLICABLE	Account type not applicable
INVALID_CHARACTER	Invalid character
OUT_ACCOUNT_BALANCE	Exceeded authorized account balance limit
OUT_ACCOUNT_MONTH_BALANCE	Exceeded the credit limit allowed for the account for the month
NOT_REGISTER_TELPHONE	Unregistered mobile number
NOT_RECEIVE_BANXICO_PAYMENT	Additional accounts will not receive payments not from Banxico
INFO_STRUCTURE_INVALID	The additional information structure is incorrect
UNKNOWN_ERROR	Unknown exception
SUCCESS	Success
AMOUNT_ERROR	Wrong amount
PARAM_ERROR	Parameter error
NOT_SUPPORTED_CASH	Cash payment is not supported
NOT_SUPPORTED_CREDIT	Credit card payment is not supported
SYSTEM_ERROR	System exception
RUT_INVALID	Invalid RUT
COMPLIANCE_REJECT	Payment declined for compliance reasons
INVALID_CCI	Invalid CCI
INVALID_BANK_ACCOUNT	Invalid bank account

Payin PayType Enum

Value	Description
123	聚合收银台

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