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

2020-09-16 15:50 更新

my.ap.nsf

版本要求:基礎(chǔ)庫 1.14.0 或更高版本;若支付寶客戶端版本較低,建議做 兼容處理。

注意: 此 API 暫僅支持企業(yè)支付寶賬戶使用。

根據(jù)用戶身份特征以及行為信息,判斷用戶在先享后付場景下是否有風(fēng)險。有關(guān)先享后付保障更多信息。

評級 描述 處理建議
rank0 提供信息不足,提供參數(shù)信息有誤,或提供的支付寶賬號不存在。 請檢查入?yún)⑿畔ⅰ?/td>
rank1 用戶拒付風(fēng)險為低。 用戶可以先享受服務(wù),再進行支付。
rank2 用戶拒付風(fēng)險為中。 根據(jù)業(yè)務(wù)場景客戶自行判斷提供或者不提供。
rank3 用戶拒付風(fēng)險為高。 不建議先提供給用戶服務(wù)。

示例代碼

my.ap.nsf({
  // 請自行替換 xxxxx 各個參數(shù)
  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) {
  },
})

入?yún)?/h4>

Object 類型,屬性如下:

屬性 類型 必填 描述
pid String 小程序的開放平臺賬號。
appId StringArray 小程序?qū)?yīng)的 appId。
bizContext Map 需要識別的業(yè)務(wù)參數(shù)。
success Function 調(diào)用成功的回調(diào)函數(shù)。
fail Function 調(diào)用失敗的回調(diào)函數(shù)。
complete Function 調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)。

bizContext 屬性說明
參數(shù) 類型 必填 最大長度 描述 示例值
risk_type String 1024 用于代表商戶風(fēng)險類型,請按示例值填寫。 固定傳入riskinfo_nsf_common
pid String 128 商戶的小程序開放平臺賬號。 2088345256451234
user_id String 128 用于輸入用戶支付寶的 2088 賬號,如不了解此字段如何獲取,可了解下靜默授權(quán)。如參數(shù)無法提供,請?zhí)顚憽皀ull”。 2088501624560335
mobile_no String 128 用于輸入用戶注冊支付寶的手機號碼。如參數(shù)無法提供,請?zhí)顚憽皀ull”。 13810935692
cert_no String 128 用于輸入用戶身份證號。如參數(shù)無法提供,請?zhí)顚憽皀ull”。 13810935692
lbs String 128 用于輸入用戶產(chǎn)生交易時的地理位置信息。如參數(shù)無法提供,請?zhí)顚憽皀ull”。 30.2727707248263
sales_amount String 128 用戶購買或使用服務(wù)時產(chǎn)生的具體金額。如參數(shù)無法提供,請?zhí)顚憽皀ull”。 97.23

success 回調(diào)函數(shù)

入?yún)?Object 類型,屬性如下:

屬性 類型 描述
result Object 風(fēng)險識別的返回結(jié)果。

result 屬性說明
屬性 類型 描述 示例值
riskResult String 風(fēng)險識別結(jié)果。riskinfo_nsf_common 風(fēng)險評級結(jié)果:rank0 提供信息不足,提供參數(shù)信息有誤,或提供的支付寶賬號不存在。rank1 表示用戶拒付風(fēng)險為低rank2 表示用戶拒付風(fēng)險為中。rank3 表示用戶拒付風(fēng)險為高。riskinfo_nsf_common_infocode——表示風(fēng)險識別類型;先享后付場景下當(dāng)前類型標(biāo)識為172,無其余類型。 {\"riskinfo_nsf_common_infocode\":\"172\",\"riskinfo_nsf_common\":\"rank1\"}
riskResultDesc String 風(fēng)險信息描述。 {\"rank0\":\"等級0\"}
uniqueId String 業(yè)務(wù)唯一識別碼。用戶標(biāo)識請求信息。 0b92uueie87636222

fail 回調(diào)函數(shù)

入?yún)?Object 類型,屬性如下:

屬性 類型 描述
error String 錯誤碼。
errorMessage String 錯誤信息。

結(jié)果碼

結(jié)果碼 結(jié)果明細(xì) 解決方案
serviceNoAuth 服務(wù)未授權(quán)。 請檢查配置的賬戶是否已簽約響應(yīng)的功能包。
riskTypeNoAuth 場景(risktype)未授權(quán)。 請檢查配置的賬戶是否已簽約響應(yīng)的功能包。請檢查 risktype 參數(shù)是否正確。
bizContentEmpty 風(fēng)險數(shù)據(jù)內(nèi)容為空。 檢查入?yún)?shù)據(jù)格式。
paramMissingError 參數(shù)缺失。 檢查必傳參數(shù)是否傳入。
param error 參數(shù)錯誤。 檢查入?yún)⒏袷绞欠穹衔臋n要求。
SYSTEM_OUT_ERROR 系統(tǒng)繁忙。 請稍后再試。
INVALID_PARAMETER 缺少必選參數(shù)或參數(shù)有誤。 檢查參數(shù)是否正確或者缺失。
OVER_LIMIT 超過調(diào)用量限制。 如需增加額度,請發(fā)郵件至 RiskGoCSC@service.alipay.com 進行申請。

常見問題 FAQ

my.ap.nsf 中的兩個 pid 是否傳一致的參數(shù)?

兩者 pid 相同。

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號