创建代付

请求地址

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

头部信息（header）

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

请求参数

字段	类型	必需	最大长度	描述
merchantOrderNo	String	yes	32	商户订单号
amount	String	yes	20	代付金额(建议整数) 【单位 卢比：INR】
accountType	Integer	yes		账户类型 【1001 = BANK_TRANSFER 1002 = UPI 】
bankCode	String	no	50	含义为:ifsc 银行编码：当支付类型是1001 时是必传；用于唯一识别印度境内的每一个银行分行。 前 4 位： 银行代码（字母），如 ICIC (ICICI Bank), SBIN (State Bank of India)。 第 5 位： 固定为数字 0（预留位）。 后 6 位： 分行代码（通常是数字，但也可能是字母），识别具体的支行。示例：ICIC0000001
bankAccount	String	yes	50	收款账号 当为UPI支付方式时，账号至少包含@字符
realName	String	yes	40	用户姓名。不得包含特殊字符，建议使用全大写，长度不少于 2 个字母；无需严格校验，但需符合正常姓名格式。
phone	String	yes	10	用户手机号 【10位数】手机号,必须10位，然后6,7,8,9开头
email	String	no	64	邮箱
callbackUrl	String	no	200	代付回调地址，若不传, 则以商户配置为准
sign	String	yes		签名

请求示例

{
    "merchantOrderNo": "OrderNoExample",
    "amount": "1000",
    "accountType": 1001,
    "bankCode": "ICIC0000001",
    "bankAccount": "1234567890123456789012",
    "realName": "realName",
    "phone": "6123456789",
    "callbackUrl": "https://www.callbackexample.com",
    "sign": "YOUR_SIGN"
}

返回参数

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

成功示例

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

错误码

异常码	异常信息	处理方案
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.	未配置代收回调地址，请配置代收回调地址
432	*	卡号，银行号，支付方式匹配异常，请检查并更改
462	This request failed due to blacklist blocking	进入黑名单，请更改参数，重新拉起
473	Merchant joint verification error: *	商户配置异常，请联系我们
500	Business Error	请联系我们

返回示例

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