甬易支付文档中心

主题

商户代付新增收款人 ​

接口描述 ​

  • 开通 代付产品 业务的商户可以新增收款人信息。商户可以使用该功能验证对私代付收款人，间联商户联系运营配置是否验证，直连商户可在页面配置。
  • 对公代付当前不校验收款人信息，无需调用此接口添加收款人。

请求URL ​

  • /merchant/defray/addPayee

请求方式 ​

  • POST

公共请求参数 ​

参数名必选类型最大长度说明示例
appId是stringappId202409561403450909
signature是string签名
transNonce是string32请求流水号123456
transDate是string13请求时间，13位时间戳1731406784607

请求参数 ​

参数名必选类型最大长度说明示例
merchantNo是string32商户编号XSxxxxxxx
payeeName是string32收款人姓名(需要AES加密)JRK97dTOVaSwU3smFZ2uUQ==
payeeCertType是string32收款人证件类型(ID_CARD-身份证)ID_CARD
payeeCertNo是string32收款人证件号(需要AES加密)Lw178IM6/4jaQEpkDCbzHZqBUbML1LtR4Ew+YmcAQLo=

请求报文示例 ​

json
 {
  "appId": "202415629590370906",
  "payeeName": "JRK97dTOVaSwU3smFZ2uUQ==",
  "payeeCertType": "ID_CARD",
  "payeeCertNo": "Lw178IM6/4jaQEpkDCbzHZqBUbML1LtR4Ew+YmcAQLo= ",
  "signature": "DyvGpiKpOXZSGMhn0xdYVaCTzRmJf5XPIURn9Rsou6bHWODwFYAEb8QOACgt1gQlEUqmZYuyTXwxj7froBZ60U7X3Cn337LTjkU5eHQW3RInlc0FbA/7FzIBeLrpeHlqXo76N7wm6kPH2zcBMwCVECR86zzwyxs6wP83JFDl2mTQTMOJFgPZGN5ALOeVgw5tNTMHg7qYMe0BsyHJe1QE8MRToPXTWwS/Lh93kbOM+k/r2iJbI6n3zO35+LsDKcrpT1m6BMGkDQYy/VnnKHm/AVp/Vh7csqlQ5SefcOJfP82nmf2PHtSVNO6H7i8RH5UT1UAfo7PhSSuxdk/V0yANAg==",
  "transDate": "1731469813663",
  "transNonce": "967f5385-6b7d-43b3-8019-9883f7075b2d"
}

公共响应参数 ​

参数名必选类型最大长度说明示例
code是string响应编码00000000
message是string响应信息成功
signature是string签名
transNonce是string32请求流水号(同入参)123456
transDate是string13请求时间，13位时间戳1731406784607

响应参数 ​

参数名必选类型最大长度说明示例

响应示例 ​

json
 {
  "code": "00000000",
  "message": "成功",
  "transDate": "1731469813663",
  "transNonce": "967f5385-6b7d-43b3-8019-9883f7075b2d",
"signature": "DyvGpiKpOXZSGMhn0xdYVaCTzRmJf5XPIURn9Rsou6bHWODwFYAEb8QOACgt1gQlEUqmZYuyTXwxj7froBZ60U7X3Cn337LTjkU5eHQW3RInlc0FbA/7FzIBeLrpeHlqXo76N7wm6kPH2zcBMwCVECR86zzwyxs6wP83JFDl2mTQTMOJFgPZGN5ALOeVgw5tNTMHg7qYMe0BsyHJe1QE8MRToPXTWwS/Lh93kbOM+k/r2iJbI6n3zO35+LsDKcrpT1m6BMGkDQYy/VnnKHm/AVp/Vh7csqlQ5SefcOJfP82nmf2PHtSVNO6H7i8RH5UT1UAfo7PhSSuxdk/V0yANAg=="
}

备注 ​