新建付款方

新建付款方是将个人银行卡和商户建立绑定关系，支付时不再需要输入银行卡信息。商户需先进行创建付款方。创建之后调用预绑卡接口银行会发送短信验证码给持卡人，商户再使用确认绑卡接口将短信验证码回传给平台完成绑卡。

请求路径	/pay/payer/create
请求方法	POST

请求参数

公共参数

参数	名称	类型	必填	说明
key	标识	string	是	开发者唯一标识
time	时间戳	string	是	当前 unix 时间戳，精确到秒
sign	数据签名	string	是	数据签名，详见 签名算法
data	业务参数	JSON string	是	业务参数，详见下例表格

业务参数

参数	名称	类型	必填	说明
card_name	银行卡户名	string	是	银行卡户名
card_bank	银行	string	是	见查询银行卡列表接口
card_mobile	银行预留手机号码	string	是	银行预留手机号码
card_account	银行账号	string	是	银行卡号
identity	身份证件号码	string	是	身份证件号码
remark	备注	string	否	备注

请求示例

{
    "data": "{\"card_account\":\"xxxxxxx\",\"card_bank\":\"03080000\",\"card_mobile\":\"18516603807\",\"card_name\":\"xxxx\",\"identity\":\"xxxxxx\",\"remark\":\"测试\"}",
    "key": "d2b945d769dab6a8e32",
    "sign": "39e3266ac6b5dd575aeeb49ced45d839030022abc78120a9b03e1d73d4584d09",
    "time": 1762412886
}

返回数据

公共数据

数据	名称	类型	必填	说明
code	状态码	int	是	结果状态码
text	操作结果	string	否	操作结果，为空时不返回此字段
time	时间戳	int	是	服务器当前 unix 时间戳，精确到秒
sign	数据签名	string	是	数据签名
data	业务数据	JSON string	是	业务数据，详见下例表格

业务数据

数据	名称	类型	必填	说明
code	付款方编码	string	是	付款方编码
card_name	银行卡户名	string	是	银行卡户名
card_bank	银行	string	是	见查询银行卡列表接口
card_mobile	银行预留手机号码	string	是	银行预留手机号码
card_account	银行账号	string	是	银行卡号
identity	身份证件号码	string	是	身份证件号码
remark	备注	string	否	备注
state	状态	string	是	状态

状态表

参数	说明
pending	待签约
confirm	待授权
reject	已拒绝
accept	已签约
unbind	已解绑

返回示例

{
    "code": 0,
    "data": "{\"card_account\":\"xxxxxxx\",\"card_bank\":\"01020000\",\"card_mobile\":\"xxxxxxxx\",\"card_name\":\"xxxxxx\",\"code\":\"P7443987\",\"identity\":\"xxxxxxx\",\"remark\":\"测试\",\"state\":\"pending\"}",
    "sign": "d6df59eb4dab30ea549fede97e0b2eb4453208444d45fe206a406578d0835da5",
    "text": "添加成功",
    "time": 1762413957
}

返回状态

状态	说明
0	成功