连连开放平台文档

付款人认证申请

POST/v1/global-payout/payer/apply

请求参数

mch_id

string

商户编号

必需

商户编号是商户在平台上开设的商户号码，为18位数字

<= 18 字符

sub_mch_id

string

子商户编号

可选

子商户号（平台商模式下必传），为18位数字

txn_seqno

string

申请唯一编号

必需

<= 64 字符

payer_id

string

必需

商户侧付款人唯一id

<= 64 字符

payer_name

string

付款人名称

必需

<= 64 字符

payer_type

enum<string>

付款人类型

必需

<= 16 字符

枚举值:

PERSONCOMPANY

id_type

enum<string>

付款人证件类型

必需

<= 32 字符

枚举值:

ID_CARDUNIFIED_CREDIT_CODE

id_no

string

必需

付款人证件号,该字段需要连连RSA公钥加密传输。

<= 32 字符

phone

string

必需

联系手机号,该字段需要连连RSA公钥加密传输。

<= 32 字符

country_code

string

必需

付款人常驻国家或地区编码（标准二位编码），参考：https://en.wikipedia.org/wiki/ISO_3166-2

<= 2 字符

notify_url

string

可选

付款人认证结果通知地址，如上送则向该地址发送认证结果通知

<= 256 字符

{
  "mch_id": "string",
  "txn_seqno": "string",
  "notity_url": "string",
  "payer_id": "string",
  "trade_name": "string",
  "user_type": "string",
  "user_name": "string",
  "id_type": "string",
  "id_no": "string",
  "user_country_code": "string"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

ret_code

string

响应码

必需

ret_msg

string

响应信息

必需

mch_id

string

商户号

必需

商户编号是商户在平台上开设的商户号码，为18位数字

<= 18 字符

txn_seqno

string

商户系统唯一交易流水号

必需

platform_txno

string

平台订单号

必需

payer_id

string

必需

商户侧付款人唯一id

<= 18 字符

platform_payer_id

string

平台付款人id

可选

受理成功时返回

txn_status

enum<string>

处理状态

必需

枚举值:

PROCESSINGFAILSUCCESS

fail_reason

string

失败原因

必需

{
  "ret_code": "string",
  "ret_msg": "string",
  "mch_id": "string",
  "txn_seqno": "string",
  "platform_txno": "string",
  "payer_id": "string",
  "platform_payer_id": "string",
  "txn_status": "PROCESSING",
  "fail_reason": "string"
}