Skip to content

Payout Account Type

ValueDescription
0Airtel
1Tigo
2Halotel(SandBox Not supported yet)
3Vodacom(SandBox Not supported yet)

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.

There is no bank list in Tanzania

Payout Order Status Enum

ParameterDescriptionRemark
PROCESSINGPROCESSING
WAITINGWait for payment
PAYINGPayment Paying
SUCCESSPayment successfulOrder final status
FAILPayment failedOrder final status
CANCELOrder CanceledOrder 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

说明
PAYMENT_OFFSETPayment offset
ACCOUNT_AND_MNO_NOT_MATCHThe account and Mno do not match
UNKNOWN_ERRORUnknown error

Payin PayType Enum

ValueDescription
810AirtelMoney
811TigoPesa
812Halotel
813Vodacom(SandBox Not supported yet)
821NormalUssd
888PayLink

TIP

810-813 are Push methods, and 821 and 888 are URL methods.

Payin Order Status Enum

ParameterDescriptionRemark
PAYINGWait for payment
SUCCESSPayment successfulOrder final status
FAILPayment failedOrder 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

ValueDescriptionCountries covered
System_errorSystem errorAll
System_busySystem busy (Can retry)All
System_MaintenanceSystem Maintenance (Can retry)All
MerchantId_is_nullMerchantId is emptyAll
Sign_verify_errorMerchant signature verification errorAll
RequestMethod_not_postNot a POST requestAll
RequestContentType_not_jsonNot an application/json requestAll
RequestBody_is_nullThe request body is emptyAll
MerchantId_not_NumberMerchantId is not a numberAll
MerchantId_is_errorMerchant Id errorAll
Request_ip_notWhiteListRequest ip non-whitelistAll
Params_jsonFormat_errorRequest body json format errorAll
Params_xxx_RequiredParameter xxx is requiredAll
Params_xxx_errorParameter xxx errorAll
Params_accountNo_Format_isIncorrectThe bank account number format is incorrect (the length of the bank card number does not match the bank)Some countries
Merchant_amount_notEnoughMerchant balance is insufficientAll
Merchant_not_enabledMerchant is not enabledAll
Merchant_not_existMerchant does not existAll
Params_order_notExistThe platform order number does not existAll
Params_mchOrderNo_notExistThe merchant order number does not existAll
Params_mchOrderNo_repeatDuplicate merchant order numberAll
Channel_Maintenance_timeThe channel is under maintenance, please contact technical support for testing environmentAll
Tran_risk_interceptTransaction risk control interception, check whether the amount meets the restriction conditionsAll
Params_accountName_Maximum<40>charactersPayout (beneficiary) payee name is too longSome countries,MX is 40 characters
Params_idType_Exists_idCard_CPF_InvalidateCPF Number InvalidateBR
COLLECTION_ACCOUNT_DAY_LIMITThe number of times the payment card number reaches the daily limit limitAll
COLLECTION_NAME_DAY_LIMITThe number of times the payee name reaches the daily limit limitAll
LIMIT_MIN_AMOUNTThe order amount is less than the minimum amount limitAll
LIMIT_MAX_AMOUNTThe order amount is higher than the maximum amount limitAll
BLACK_LIST_USER_LIMITThe user is on the blacklistAll
Params_realName_not_contain_ChineseAccount names are not allowed to contain ChineseAll
Params_accountName_not_contain_ChineseAccount names are not allowed to contain ChineseAll
Params_accountNo_Clabe_InvalidateClabe is invalidMexico
Params_email_format_invalidThe email format is invalidMexico
Params_email_length_exceeds<64>charactersThe mailbox length exceeds 64 characters (the mailbox length should be kept below 64 characters)All

Released under the MIT License.