带风控信息的收款
在支付过程中提供风险信息,我们可以为您检测和预防欺诈,节省您处理欺诈的时间,提高您的交易成功率,保证您的资金安全。
HTTP 请求
Request Headers
{
"Content-Type": "application/json",
"Authorization": "Bearer {{access_token}}",
"x-api-key": "{{api_key}}"
}
Request Body
{
"idempotencyKey": "7fd3ab68-1aa3-4e8f-852d-592b7250f296",
"amount": 100000,
"currency": "BRL",
"country": "BR",
"paymentMethod": "CREDIT_CARD",
"paymentFlow": "REDIRECT",
"callbackUrl": "https://api.client.com/callback/"
... # other basic request fields
"riskData": {
"PAYER_IP_ADDRESS":"192.0.0.130",
"PAYER_LOGIN_ID": "1234567890",
"MERCHANT_APP_NAME": "Liquido"
},
... # other basic request fields
}
HTTP Headers 字段说明
Key | Value |
---|---|
Authorization | "bearer" + " " + {{access_token}} |
x-api-key | {{api_key}} |
Request Body 字段说明
参数 | 必填 | 类型 | 描述 |
---|---|---|---|
riskData | JSON | 支付的风险信息,其中字段可以为常见风险中的任意项。 |
MERCHANT_APP_NAME or MERCHANT_WEBSITE must be provided in risk data.
常见风险
名称 | 类型 | 描述 | 例子 | 备注 |
---|---|---|---|---|
PAYER_IP_ADDRESS | string | 支付人的IP地址 | 201.103.34.138 | |
PAYER_DEVICE_ID | string | 支付人的设备ID | c9380c4c-bfc3-42c9-9120-22d1db2d53af | |
PAYER_AGE | number | 支付人年龄 | 37 | |
PAYER_EMAIL_IS_CONFIRMED | string | 支付人的邮箱地址是否已确认? | Yes | 邮箱是否通过了验证链接? Yes / No |
PAYER_EMAIL_LAST_CHANGE_IN_DAYS | number | 支付人的邮箱最后的改变,至今多少天 | 190 | 单位是天 |
PAYER_SINCE_IN_DAYS | number | 支付人创建至今多少天 | 190 | 单位是天 |
PAYER_LAST_LOGIN_IN_DAYS | number | 支付人上次登录至今多少天 | 5 | 单位是天 |
PAYER_LAST_PASSWORD_CHANGE_IN_DAYS | number | 支付人上次修改密码至今多少天 | 90 | 单位是天 |
PAYER_FIRST_PURCHASE_IN_DAYS | number | 支付人第一次付款至今多少天 | 190 | 单位是天 |
PAYER_LAST_PURCHASE_IN_DAYS | number | 支付人最后一次付款至今多少天 | 60 | 单位是天 |
PAYER_APPROVED_PURCHASE_COUNT | number | 支付人已被批准的购买次数 | 5 | |
PAYER_REJECTED_PURCHASE_COUNT | number | 支付人已被拒绝的购买次数 | 1 | |
PAYER_AVG_PURCHASE_FREQUENCY | number | 支付人的购买频率 | 支付人至今天数 / 已批准的购买数量 | |
PAYER_AVG_AMOUNT_SPENT | number | 支付人的平均支付金额 | 212.35 | 被通过的订单总金额 / 已批准的购买数量 |
PAYER_AMOUNT_DEVIATION | number | 支付人金额偏差 | 1.25 | 被通过的订单总金额 / 至今支付金额平均值 |
PAYER_PHONE_IS_CONFIRMED | string | 支付人的电话是否已确认? | No | 电话号码通过了短信验证? Yes / No |
PAYER_PHONE_LAST_CHANGE_IN_DAYS | number | 支付人上次修改电话号码至今多少天? | 190 | 单位是天 |
PAYER_ADDRESS_LAST_CHANGE_IN_DAYS | number | 支付人上次修改地址至今多少天? | 190 | 单位是天 |
PAYER_IS_EMPLOYEE | string | 支付人是雇员吗? | No | Yes / No |
PAYER_IS_VIP | string | 支付人是VIP吗? | No | Yes / No |
PAYER_LOGIN_ID | string | 支付人的登录ID | ivan.souza.br | |
ORDER_PRODUCT_TYPE | string | 订单产品类型 | digital goods | Enum: Physical goods / Digital goods / Services |
ORDER_SHIPPING_METHOD | string | 订单交易方式 | Delivery | Enum: Delivery / Pick-up / Digital |
ORDER_NUM_PAYMENT_RETRIES | number | 订单交易的重试方式 | 2 | 在事先授权的情况下,上传付款重试的次数 |
ORDER_COUPON_CODE | string | 订单促销优惠券 | BABIESDAY | |
ORDER_USES_GIFT_CARD | string | 订单是否用力礼品卡? | No | Yes / No |
ORDER_GIFT_MSG | string | 订单给收件人的礼物消息 | Dear sister happy birthday xxx John | 发送的消息 |
ORDER_MOST_RISKY_ITEM | string | 订单购物车中最危险的商品(通常是最昂贵的) | Samsung Galaxy S23 Ultra | |
ORDER_MOST_RISKY_ITEM_TYPE | string | 订单风险最高的产品类别 | Smartphone | Enum: Smartphone / Food / Beverages / Fashion / Home appliances/ etc. |
ORDER_SHIPPING_FEE | number | 订单运费 | 5.15 | |
SELLER_BUSINESS_CATEGORY | string | 卖家垂直商业类型 | Games | Enum: Games / Retail / Clothing / Health |
SELLER_MARKETING_TYPE | string | 卖家是B2C还是B2B | B2C | |
SELLER_SINCE_IN_DAYS | number | 卖家至今多少天 | 2317 | 单位是天 |
SELLER_AVG_ORDER_AMOUNT | number | 卖家平均订单金额 | 170 | |
SELLER_AMOUNT_DEVIATION | number | 卖家本次交易偏离度 | 1.47 | 本次订单总价 / 卖家平均订单金额 |
MERCHANT_APP_NAME | string | 商户应用名称 | 交易所对应的商户APP。与merchantWebsite字段不能同时为空 | |
MERCHANT_WEBSITE | string | 商户网站名称 | 交易所对应的商户网站。与merchantAppName字段不能同时为空 |