跳转到内容

创建代付

请求地址

method	url
POST	/api/pay/payout/create/v1

header参数	入参参数描述
timestamp	请求时间戳
nonce	随机值
country	PE
app_code	app编号

请求参数

字段	类型	必需	长度	描述
merchantOrderNo	String	yes	32	商户订单号
amount	String	yes	20	代付金额(索尔)
phone	String	no	9	9开头 9位数字
bankCode	String	yes	50	银行编码
bankName	String	yes	50	银行名称
accountType	Int	yes		账户类型, AHORRO:101(储蓄) CORRIENTE:102(活期) WALLET（103）
bankAccount	String	yes	50	收款账号；当账户类型为103 Wallet时请传输钱包账号
cciNumber	String	yes	50	20位纯数字跨行转账账号：2025年5月25号之后必传输
realName	String	yes	50	用户姓名不包含特殊字符，建议全大写
idCardNumber	String	yes	50	收款人证件号码
idType	Stirng	yes	32	证件类型,身份证:DNI(8位数),税号:RUC(11位数),外国人身份证:CE(9位数）, 护照:PA(9位数）
callbackUrl	String	no	200	代付回调地址，若不传, 则以商户配置为准
sign	String	yes		签名

{
    "bankAccount": "1234567899276",
    "bankCode": "2",
    "bankName": "INTERBANK",
    "realName": "TEEMO",
    "amount": "100.00",
    "idType": "DNI",
    "phone": "123456789",
    "cciNumber": "12345678901203910293",
    "accountType": "101",
    "idCardNumber": "12345678",
    "sign": "YOUR_SIGN",
    "callbackUrl": "https://www.callbackexample.com",
    "merchantOrderNo": "OrderNoExample"
}

返回参数

参数	类型	必需	长度	描述
merchantOrderNo	String	yes	32	商户订单号
tradeNo	String	yes		平台订单号
status	Int	yes		代付状态,1:支付中 3:失败(可以重新发起)
amount	String	yes		交易金额

{
    "msg": "success",
    "traceId": "747bbf80261844ed85b809212aab0d81.85.17422898158610298",
    "code": 200,
    "data": {
        "amount": "100.00",
        "merchantOrderNo": "OrderNoExample",
        "status": 1,
        "tradeNo": "TF2501010001PE0000000000000000"
    }
}

错误码

异常码	异常信息	处理方案
412	Please try again later	请稍后重试
414	*	更改对应参数
417	Merchant account not found	商户账户未找到，请联系我们
425	Insufficient merchant balance	商户账户余额不足
426	merchant order duplicate	请更换商户订单号
427	The callback notification address for collection must not be empty.	未配置代收回调地址，请配置代收回调地址
429	* bankAccount length must be * digits	对应的支付方式和银行匹配的卡号位数不匹配
429	The 3rd digit from the end of a BCP account number must be either 0 or 1.	bcp银行卡号对应的倒数第三位一定是0/1，请检查并更改
432	*	卡号，银行号，支付方式匹配异常，请检查并更改
462	This request failed due to blacklist blocking	进入黑名单，请更改参数，重新拉起
473	Merchant joint verification error: *	商户配置异常，请联系我们
475	The id card type is error	证件类型异常，请检查并更改
476	The id card number is error	证件号异常，请检查并更改
500	Business Error	请联系我们

{
    "code": 425,
    "data": null,
    "msg": "Insufficient merchant balance",
    "traceId": "747bbf80261844ed85b809212aab0d81.85.17422898158610298"
}