H Honor
ZH
DiDi finanzas

文档中心

提供接入指南、接口文档、测试指引等全流程接入所需信息

2.2 Prescreen

Prescreen 预热

  • Path： /external/prescreen/v1

  • Method: POST

  • API 说明：合作方可通过该接口校验用户是否可以使用 DiDi 先享后付支付方式。若接口返回结果为 SUCCESS，即代表该用户可使用 DiDi 先享后付支付方式，用于让用户预先核验自身是否具备 DiDi BNPL 的使用权限。

Request Message

Request Headers

字段名称 字段说明 参数值 展示 (必填​**/选填/条件性)** 备注
Content-Type Content Type application/json 必填
Authorization This is the partner’s identity authentication value. Bearer {ACCESS-TOKEN} 必填 详情请参考 "第2部分 DiDi BNPL合作伙伴配置和环境设置".
合作伙伴可以获取 ACCESS-TOKEN 来自令牌API调用的值。
当访问凭证过期时，再次调用令牌API以获取新的访问令牌。
X-Paylater-Request-Id uuid uuid.
Example: 550e8400-e29b-41d4-a716-446655440000		 必填 必填的UUID v4字符串。滴滴将拒绝格式无效的请求。

Request Body

字段名称 类型 字段说明 展示 (必填​**/选填/条件性)** 备注
partnerUid String 商户侧用户ID 必填 请传入商户侧的用户UID
partnerOrderId String 商户侧支付订单ID（幂等键）。 必填 幂等键。
商户为该特定交易生成的唯一支付流水号。
⚠️ 运维关键提示：
该ID必须在您的客户服务系统（CS）和订单管理系统（OMS）中明确可见且支持搜索。 它将作为跨平台对账、故障排查以及处理客户投诉的主要参考编号。 请勿使用隐藏的后端ID或数据库主键，否则会在客服升级处理过程中造成严重阻碍并大幅提升沟通成本。
partnerOrderAmount Long 订单金额 必填 应用所有商户折扣后的实际支付金额。
计算规则：原始金额必须乘以100。（严禁传递浮点数/小数）。
币种与单位：必须对应墨西哥比索（MXN）。所需单位为分（即该货币的最小单位，西班牙语为centavos）。
示例：若订单金额为99.99 MXN，传输的数值必须为9999。
currency String 币种 必填 墨西哥比索
extendInfo Object 扩展信息 必填
deviceInfo 必填
deviceId String 设备ID 条件性 用于反欺诈与信用风险评估的设备标识符。
  • 业务逻辑：

  • If operateSource = APP：必填。必须传入真实的原生硬件标识符（例如 iOS 端的 IDFA/IDFV，或 Android 端的 Android ID/OAID）。

  • 如果 operateSource = WEB/WAP：选填。
androidId String 安卓设备ID 选填 用于安卓设备识别。
iosId String iOS设备ID 选填 idfa/idfv
用于iOS设备识别。
gps String 经纬度坐标 选填 结账时终端用户的实时地理坐标。
ip String 公网IP 必填 最终用户结账时的公网IP地址，对于风控区域校验至关重要。
业务逻辑：
- 若 operateSource = APP：取消费者移动设备当前的公网IP地址。
- 若 operateSource = WEB/WAP：取消费者电脑/浏览器当前的公网IP地址。
重要提示：
禁止传入后端服务器的IP或内网IP地址（例如127.0.0.1、192.168.x.x），否则将直接触发风控拦截。
operateSource String 操作来源（网页/应用） 必填 终端用户发起交易的渠道或平台上下文。
格式与规则：必须与以下其中一个精准枚举值完全匹配：
- WAP：移动浏览器环境（例如用户未下载原生应用，直接在手机上通过 Safari 或 Chrome 打开 Shein）。
- WEB：桌面端或PC浏览器环境。
- APP：移动端原生应用客户端。
lang String 语言 选填 枚举值：
en-US
es-MX
如果未传入或传入的值无效，默认值为es-MX。
userInfo Object 用户信息 必填
partnerEmail String 商户端用户邮箱 条件性 通常情况下，该字段为选填项。
仅当您的公司满足以下条件时，该字段才会变为必填项：
  • 因自身平台设计原因无法提供 partnerPhone ，且

  • 已获得滴滴先享后付支持团队的批准，允许在 partnerPhone 创建支付订单 接口中移除 API。
partnerPhone String 用户手机号码 必填 此字段为必填项。该字段的信息要求如下：
1. 最优方案：用户上次登录时使用的手机号码： 这是您所能提供的最优、最便捷的方案。

2. 替代方案：用户更换绑定手机号时录入的手机号码。

3. 底部选项：用户注册时最初提供的手机号码： 如果该手机号码已被更改，请为滴滴更新为最新的号码。

该手机号码是先买后付（BNPL）交易中最重要的字段之一，且为必填项。
备注：若贵司因某些特殊原因无法向滴滴提供该字段，请协助联系滴滴先买后付（BNPL）支持团队说明缘由。
phoneCountryCode String 用户手机号码的国家代码 必填 规则与字段“partnerPhone”保持一致。
regTime String 用户注册时间 条件性 终端用户在商户平台上注册其账户时的时间戳。
格式：ISO 8601 yyyy-MM-dd'T'HH:mm:ss.SSSXXX。时区偏移是强制必填项。
示例：2025-12-08T01:11:33.000-06:00
规则:
如果 newUserFlag 不存在，该字段为必填项。
如果 newUserFlag 已存在，该字段为可选项。
newUserFlag String 是否为新用户 条件性 用于标识最终用户是否为过去30天内在商户平台上新注册的用户的标记。
格式与规则: 枚举字符串值：
- 1：新用户（最近30天内注册）。
- 0：老用户（注册超过30天）。
规则：
若regTime字段缺失，该字段为必填项。
若regTime字段已提供，该字段为可选项。
nickName String 用户昵称 选填
userLevel String 用户等级 选填 用户在商户平台上的综合分级或会员忠诚度等级。
代表商户内部用户分级体系的自由格式字符串。
示例：VIP_LEVEL_3 或 PLATINUM_MEMBER 或 HIGH_CREDIT_SCORE 或其他取值。
smeTag Boolean 小微企业标签 选填 枚举值：true / false / null
true——该企业为小型或微型企业。
false——该企业并非小型或微型企业。
null——无可用数据。
lastSuccInstrument String 上一次成功的支付方式 选填 用户（在商户平台上）在上一笔成功交易中使用的支付工具。
fees List<Object> 费用项 选填 订单附加费用的详细清单（例如运费、税费），用于分项明细展示与审计。
type String 类型 选填 费用项的具体类别划分，目前仅支持使用枚举值。 POSTAGE-POSTAGE （运输/配送费）。
枚举值：
POSTAGE-POSTAGE
amount Long 货币金额 选填 费用项的准确财务数值，以货币最小单位的长整型整数表示（例如墨西哥比索的分）。
additionalRiskData String 附加风险数据 选填 附加风险数据
marketingFlag String 营销标志 选填 用于标识本次交易是否应用了营销推广、折扣或营销活动的标志。
1 - 已营销
0 - 非营销活动
items List<Object> 商品信息 选填 若同一SKU存在多个数量，仅需修改对应数量即可。
categoryId String 商品类目的唯一标识符 选填
categoryName String 商品类目名称 选填
skuId String 商品SKU的唯一标识符 选填
skuName String 商品SKU名称 必填 商品SKU名称
goodsName String 用户可见的展示字段 选填 商品名称
unitPrice Long 实际单价（折扣后） 选填 金额单位为分。例如，若商品价格为99.99比索，此处应传入数值9999。该字段存在时必须上传。
skuCurrency String 币种 选填 ISO 4217标准——墨西哥使用MXN
quantity Integer 编号 选填
pictureUrl String 商品图片链接 选填
shippingAddress String 收货地址 选填 填写街道地址
shippingAddress2 String 收货地址 选填 填写单元地址
shippingPostcode String 收货邮政编码 选填
shippingPhoneNumber String 收货手机号码 选填
shippingPhoneCountryCode String 收货手机号码国家代码 选填 52
seller Object 卖家信息 选填
sellerId String 卖家唯一ID 条件性 进行交易的实际卖家或子商户/门店的唯一标识符。
- 平台模式商户（例如，交易市场）：属于严格必填项（M），用于追踪各个子店铺。
- 直接面向消费者（DTC）/直销商户：选填（O）。
sellerName String 卖家名称 选填
sellerRegTime String 卖家注册时间 选填 格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX，例如 '2025-12-08T01:11:33.000-06:00'，时区偏移为必填项。
mccCode String 商户类别代码 条件性 商户经营类型。
- 平台模式商户（例如电商平台）：该项为严格必填（M），用于追踪各个子店铺的信息。
- 直接面向消费者（DTC）/直销商户：该项为选填（O）。
type String 商品类型 选填 枚举值：
PHYSICAL_GOOD
VIRTUAL_GOOD
metadata String 元数据信息 选填 DiDi先享后付将通过查询接口和订单回调接口提供该信息
JSON格式

请求示例

{
  "partnerUid": "01213121131",
  "partnerOrderId": "ea7ed173-xxxx-11ef-b32d-ca3c6358d263",
  "partnerOrderAmount": 5000,
  "currency": "MXN",
  "extendInfo": {
    "deviceInfo": {
      "deviceId": "abcdef123456",
      "androidId": "4af23b10c29d58e1",
      "iosId": "E621E1F8-C36C-495A-93FC-0C247A3E6E5F",
      "gps": "19.4326,-99.1332",
      "ip": "187.137.42.155",
      "operateSource": "APP",
      "lang": "es-MX"
    },
    "userInfo": {
      "partnerEmail": "test@crecmexico.org",
      "partnerPhone": "5522612379",
      "phoneCountryCode": "+52",
      "regTime": "2025-07-12T10:25:06.509-06:00",
      "newUserFlag": "0",
      "nickName": "3wqqw121",
      "userLevel": "VIP_LEVEL_3",
      "smeTag": true,
      "lastSuccInstrument": "SPEI"
    },
    "fees": [
      {
        "type": "POSTAGE-POSTAGE",
        "amount": 100
      }
    ],
    "additionalRiskData": "{}",
    "marketingFlag": "1"
  },
  "items": [
    {
      "categoryId": "mx_mp_001",
      "categoryName": "Electronics",
      "skuId": "mx_mp_phone_001",
      "skuName": "Smartphones",
      "goodsName": "Premium Smartphone 128GB",
      "unitPrice": 4900,
      "skuCurrency": "MXN",
      "quantity": 1,
      "pictureUrl": "<https://img.merchant.com/p/phone001.jpg>",
      "shippingAddress": "Calle la asomada",
      "shippingAddress2": "47 Planta 2",
      "shippingPostcode": "54715",
      "shippingPhoneNumber": "5522612379",
      "shippingPhoneCountryCode": "52",
      "seller": {
        "sellerId": "11312131",
        "sellerName": "test-sell",
        "sellerRegTime": "2024-10-14T02:30:39.000-06:00",
        "mccCode": "5732"
      },
      "type": "PHYSICAL_GOOD"
    }
  ],
  "metadata": "{}"
}

Response Message

Response Header

字段名称 字段说明 参数值 展示 (必填​**/选填/条件性)** 备注
Content-Type Content Type application/json 必填

Response Body

字段名称 类型 字段说明 展示 (必填​**/选填/条件性)** 备注
code String 返回码 必填 枚举值：
SUCCESS
FAILED
RATE_LIMIT
INVALID_TOKEN
message String 响应码描述 必填
error Object 错误 选填
errorCode String 错误码 选填 枚举：
IllegalParams–参数异常
GeneralError–内部错误
PaylaterRuleRejected–被先享后付规则拒绝
RiskRuleRejected–被风控规则拒绝
OverdueRepayment–用户存在逾期还款
CreditNotEnough–信用额度不足
PaylaterRuleDissatisfy–不满足先享后付规则要求
RiskControlRejected–被风控拒绝
errorMessage String 错误码说明 选填

返回示例

{
  "code": "SUCCESS",
  "message": "SUCCESS",
  "error": null
}
复制成功