支付宝小程序API 先享后付款

2020-09-16 15:50 更新

my.ap.nsf

版本要求:基础库 1.14.0 或更高版本;若支付宝客户端版本较低,建议做 兼容处理

注意: 此 API 暂仅支持企业支付宝账户使用。

根据用户身份特征以及行为信息,判断用户在先享后付场景下是否有风险。有关先享后付保障更多信息。

评级 描述 处理建议
rank0 提供信息不足,提供参数信息有误,或提供的支付宝账号不存在。 请检查入参信息。
rank1 用户拒付风险为低。 用户可以先享受服务,再进行支付。
rank2 用户拒付风险为中。 根据业务场景客户自行判断提供或者不提供。
rank3 用户拒付风险为高。 不建议先提供给用户服务。

示例代码

my.ap.nsf({
  // 请自行替换 xxxxx 各个参数
  pid:'xxxxxxxxxxxxxxxx',
  appId:'xxxxxxxxxxxxxxxx',
  bizContext: {
        "risk_type": "riskinfo_nsf_common", 
        "user_id": "xxxxxxxxxxxxxxxx", 
        "lbs": "xx.xxxxxxxxxxxxx", 
        "sales_amount": "xx", 
        "mobile_no": "null", 
        "pid": "xxxxxxxxxxxxxxx",
        "cert_no": "xxxxxxxxxxxxxxxxxxx"
  },
  success(e) {
  },
})

入参

Object 类型,属性如下:

属性 类型 必填 描述
pid String 小程序的开放平台账号。
appId StringArray 小程序对应的 appId。
bizContext Map 需要识别的业务参数。
success Function 调用成功的回调函数。
fail Function 调用失败的回调函数。
complete Function 调用结束的回调函数(调用成功、失败都会执行)。

bizContext 属性说明
参数 类型 必填 最大长度 描述 示例值
risk_type String 1024 用于代表商户风险类型,请按示例值填写。 固定传入riskinfo_nsf_common
pid String 128 商户的小程序开放平台账号。 2088345256451234
user_id String 128 用于输入用户支付宝的 2088 账号,如不了解此字段如何获取,可了解下静默授权。如参数无法提供,请填写“null”。 2088501624560335
mobile_no String 128 用于输入用户注册支付宝的手机号码。如参数无法提供,请填写“null”。 13810935692
cert_no String 128 用于输入用户身份证号。如参数无法提供,请填写“null”。 13810935692
lbs String 128 用于输入用户产生交易时的地理位置信息。如参数无法提供,请填写“null”。 30.2727707248263
sales_amount String 128 用户购买或使用服务时产生的具体金额。如参数无法提供,请填写“null”。 97.23

success 回调函数

入参为 Object 类型,属性如下:

属性 类型 描述
result Object 风险识别的返回结果。

result 属性说明
属性 类型 描述 示例值
riskResult String 风险识别结果。riskinfo_nsf_common 风险评级结果:rank0 提供信息不足,提供参数信息有误,或提供的支付宝账号不存在。rank1 表示用户拒付风险为低rank2 表示用户拒付风险为中。rank3 表示用户拒付风险为高。riskinfo_nsf_common_infocode——表示风险识别类型;先享后付场景下当前类型标识为172,无其余类型。 {\"riskinfo_nsf_common_infocode\":\"172\",\"riskinfo_nsf_common\":\"rank1\"}
riskResultDesc String 风险信息描述。 {\"rank0\":\"等级0\"}
uniqueId String 业务唯一识别码。用户标识请求信息。 0b92uueie87636222

fail 回调函数

入参为 Object 类型,属性如下:

属性 类型 描述
error String 错误码。
errorMessage String 错误信息。

结果码

结果码 结果明细 解决方案
serviceNoAuth 服务未授权。 请检查配置的账户是否已签约响应的功能包。
riskTypeNoAuth 场景(risktype)未授权。 请检查配置的账户是否已签约响应的功能包。请检查 risktype 参数是否正确。
bizContentEmpty 风险数据内容为空。 检查入参数据格式。
paramMissingError 参数缺失。 检查必传参数是否传入。
param error 参数错误。 检查入参格式是否符合文档要求。
SYSTEM_OUT_ERROR 系统繁忙。 请稍后再试。
INVALID_PARAMETER 缺少必选参数或参数有误。 检查参数是否正确或者缺失。
OVER_LIMIT 超过调用量限制。 如需增加额度,请发邮件至 RiskGoCSC@service.alipay.com 进行申请。

常见问题 FAQ

my.ap.nsf 中的两个 pid 是否传一致的参数?

两者 pid 相同。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号