# 免密支付开通接口

最新更新时间:2024.05.16

免密支付服务开通。

# 接口说明

请求URL: https://{domain}/open-api/pay/pwdfree/sign/v1

请求方式: POST

请求参数

名称 必填 类型 说明
ownerAgreementNo 是 string 商户外部协议号,确保商户业务系统唯一,不同的用户需要传递不同的外部单号
notifyUrl 否 string 通知地址,回调签约结果
payChannel 是 string 支付渠道
payProduct 是 string 支付产品
osPaySettingNo 是 string 开放平台支付配置编号
cancelBackLink 否 string 取消开通跳转回商户的页面地址
returnBackLink 否 string 开通结束跳转回商户的页面地址

响应参数

名称 必传 类型 说明
timestamp 是 long 时间戳,标准北京时间
sign 是 string 调起签约的参数,需要在支付宝端进行签约
osAgreementNo 是 string 开放平台协议号
ownerAgreementNo 是 string 商户协议号
status 是 string 协议状态:VALID: 有效,INVALID: 无效

SDK方法

PwdFreeSignRequest request = PwdFreeSignRequest
                .builder()
                .ownerAgreementNo("xxx")
                .notifyUrl("xxx")
                .osPaySettingNo("xxx")
                .payChannel("CMB")
                .payProduct("PC_WEB")
                .build();
Results<PwdFreeSignResponse> results = payServiceRsa2.pwdFreeSign(request);
     

入参格式

{
  "ownerAgreementNo": "ownerAgreementNo_257a31db2caf",
  "notifyUrl": "notifyUrl_17ff2e123eaf",
  "osPaySettingNo": "osPaySettingNo_60d650928173",
  "payChannel": "payChannel_8c13d53b23e2",
  "payProduct": "payProduct_05b9af0ac851",
  "cancelUrl": "cancelUrl_eeea26fab075",
  "returnUrl": "returnUrl_dc7e9a34f84a"
}

出参格式:

{
  "code": 8888,
  "msg": "处理成功",
  "data": {
    "timestamp": 3,
    "sign": "xxxxx",
    "osAgreementNo": "xxxxx",
    "ownerAgreementNo": "xxxxxx",
    "status": "INVALID"
  },
  "error": null
}