支付寶小程序API 營銷反作弊

2020-09-16 15:50 更新

my.ap.preventCheat

版本需求:基礎庫 1.12.0 或更高版本,若版本較低,建議做 兼容處理

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

調用反作弊接口,根據入參說明來傳參,接口會返回當前用戶的風險識別結果,開發(fā)者可根據結果來做相應業(yè)務處理。有關營銷反作弊的產品和接入介紹。

風險識別結果

風險評級結果 描述 處理方案
rank0 表示信息不足或提供的參數(shù)有誤。 請檢查入參信息。
rank1 表示用戶作弊風險為低或者無風險。 允許用戶參加營銷活動。
rank2 表示用戶作弊風險為中。 建議給用戶營銷權益降權或攔截,或者根據客戶自身數(shù)據做進一步判斷。
rank3 表示用戶作弊風險為高。 不允許用戶參加營銷活動。

示例代碼

my.ap.preventCheat({
  // 請自行替換 xxxxx 各個參數(shù)
  pid:'xxxxxxxxxxxxxxxx',
  appId:'xxxxxxxxxxxxxxxx',
  bizContext: {
        "service": "marketing", 
        "risk_type": "riskinfo_anticheat_common", 
        "pid": "xxxxxxxxxxxxxxxx", 
        "mobile_no": "xxxxxxxxxxx", 
        "user_id": "xxxxxxxxxxxxxxxxx", 
        "bank_card_no": "xxxxxxxxxxx", 
        "client_ip": "null", 
        "email_address": "null", 
        "imei": "null", 
        "imsi": "null", 
        "mac_address": "null", 
        "extended_info": "null"
        },
  success(e) {
  },
})

入參

Object 類型,屬性如下:

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

bizContext 屬性說明

屬性 類型 必填 最大長度 描述 示例值
service String 128 合作伙伴匹配服務類型,請按照示例值填寫。 固定傳 marketing
risk_type String 1024 風險策略類型,請按照示例值填寫。 固定傳 riskinfo_anticheat_common
mobile_no String 128 用于輸入用戶注冊的手機號碼。如果沒有獲取用戶手機號,傳入 "null" 即可。 13810935692
pid String 128 申請業(yè)務合作伙伴 ID。 20881111222222
user_id String 128 支付寶用戶 ID。 20881111222233
bank_card_no String 128 銀行卡號。 62223456765456
cert_no String 128 用于輸入用戶的身份證號碼。 230109199911110921
client_ip String 128 賬戶登錄 IP。 192.168.0.1
email_address String 128 郵箱賬號。 zhifubao@163.com
imei String 128 手機序列號。 865736031418584
imsi String 128 國際移動用戶識別碼。 460001234567890
mac_address String 128 MAC 地址或設備唯一標識。 42.118.71.72
extended_info String 2048 拓展字段,其余信息通過此字段進行傳輸。業(yè)務約定:nickname:賬戶昵稱。reg_time:賬戶注冊時間。 "extended_info": { " nickname": "小螞蟻"," reg_time": "2018-10-01 00:00:09" }

success 回調函數(shù)

入參為 Object 類型,屬性如下:

屬性 類型 描述
result Object 風險識別的返回結果。

result 屬性說明

屬性 類型 描述 示例值
riskResult String 風險識別結果。riskinfo_anticheat_common**風險評級結果:rank0:表示信息不足 / 參數(shù)有誤。rank1:表示用戶作弊風險為低。rank2:表示用戶作弊風險為中。rank3:表示用戶作弊風險為高。riskinfo_anticheat_common_infocode—風險評級說明:**171:作弊風險 {\"riskinfo_anticheat_common\":\"rank3\",\"riskinfo_anticheat_common_infocode\":\"171\"}
riskResultDesc String 風險信息描述。 {\"rank0\":\"等級0\"}
uniqueId String 業(yè)務唯一識別碼,用戶標識請求信息。 0b92uueie87636222

fail 回調函數(shù)

入參為 Object 類型,屬性如下:

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

錯誤碼

錯誤碼 錯誤描述 解決方案
serviceNoAuth 服務未授權。 請檢查配置的賬戶是否有當前接口權限以及 service 參數(shù)是否正確。
riskTypeNoAuth 場景(risktype)未授權。 請檢查 risktype 參數(shù)是否正確。
bizContentEmpty 風險數(shù)據內容為空。 檢查入參格式。
paramMissingError 參數(shù)缺失。 檢查必傳參數(shù)是否傳入。
param error 參數(shù)錯誤。 檢查入參格式是否符合文檔要求。
SYSTEM_OUT_ERROR 系統(tǒng)繁忙。 請稍后再試。
INVALID_PARAMETER 缺少必選參數(shù)或參數(shù)有誤。 檢查參數(shù)是否正確或者缺失。
OVER_LIMIT 超過調用量限制。 如需增加額度,請發(fā)郵件至 RiskGoCSC@service.alipay.com 進行申請。
以上內容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號