跳转至

带风控信息的收款

在支付过程中提供风险信息，我们可以为您检测和预防欺诈，节省您处理欺诈的时间，提高您的交易成功率，保证您的资金安全。

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 或 MERCHANT_WEBSITE 在riskData中必须填一个。

常见风险

名称 类型 描述 例子 备注
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字段不能同时为空
回到页面顶部