H Honor
ZH
DiDi finanzas

文档中心

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

2.3 Create Payment Order

2.3 Create Payment Order 创建支付订单

  • Path： /external/checkout/v1

  • Method: POST

  • API 说明： 该接口是创建订单的核心接口。当用户在您的结账页面选择 “DiDi Paga Después”支付方式时，您的系统需要触发 创建支付订单 接口。

Request Message

Request Headers

字段名称 字段说明 参数值 展示 (必填​**/选填/条件性)** 备注
Content-Type 内容类型 application/json 必填
Authorization 该字段为合作方的身份认证凭据值。 Bearer {ACCESS-TOKEN} 必填 详情请参阅 “第二部分 滴滴先享后付合作伙伴配置与环境搭建”。
合作方可通过调用 ACCESS-TOKEN 令牌API来获取该值。
当访问令牌过期时，需再次调用令牌API以获取新的访问令牌。
X-Paylater-Request-Id uuid uuid.
Example: 550e8400-e29b-41d4-a716-446655440000		 必填 强制的 UUID v4 字符串。 DiDi将拒绝格式无效的请求。

Request Body

字段名称 类型 字段描述 展示 (必填​**/选填/条件性)** Remarks
partnerUid String 商户侧用户ID 必填 期望传入商户侧的UID
partnerOrderId String 商户侧支付订单ID（幂等键）。 必填 幂等键。
商户为该特定交易生成的唯一支付流水号。
⚠️ 操作关键提示：
该ID必须在您的客户服务（CS）系统和订单管理系统（OMS）中明确可见且支持搜索。
它将作为跨平台对账、问题排查以及处理客户投诉的核心参考编号。
请勿使用隐藏的后端ID或数据库主键，否则会在客户服务升级处理过程中引发严重阻碍并产生高昂的沟通成本。
orderCreateTime String 订单创建时间 必填 该字段应准确代表终端用户点击下单的时刻（即原始订单的生成时间）。
格式：ISO 8601 yyyy-MM-dd'T'HH:mm:ss.SSSXXX。（注意：SSS 代表三位毫秒数，XXX 代表时区偏移量）。
时区：必须严格提供时区偏移量。滴滴将根据您提供的偏移量自动将该时间转换为本地时间。 示例：
  • 墨西哥城时间：2025-12-08T14:30:15.123-06:00

  • 北京时间：2025-12-08T14:30:15.123+08:00
partnerOrderAmount Long 订单金额 必填 应用所有商户优惠后的实际支付金额。
计算方式: 原始金额必须乘以100。（请勿传递浮点数/小数）。
货币与单位: 必须对应墨西哥比索（MXN）。所需单位为分（货币最小单位）。
示例: > 当订单金额为99.99墨西哥比索（MXN）时，传输的数值必须为9999。
redirectUrl String 跳转URL 必填 在“先享后付（DiDi Paga Después）”页面完成支付操作后，无论支付成功还是失败，系统都会解析并返回该URL。
这主要是页面与页面之间的交互流程。
系统不会验证该URL是否能够正常重定向。
redirectAppLink String App 跳转链接 条件性 支付完成后，用于从滴滴 App 唤起并跳转回商户原生 App 的链接。
使用规则:
- 若 operateSource = APP，该字段为 必填项。
- 若 operateSource = WEB/WAP，该字段为 可选项。
链接格式：
- 深度链接公式：[品牌名称][链接]
- 示例： globalOneTravel://one/webpage?weburl=https%3A%2F%2Fpay.didiglobal.com%2Fpaga-despues%2Flanding
-> 细分说明:
** 品牌名称 - [globalOneTravel]
** 链接 - ://one/webpage?weburl=https%3A%2F%2Fpay.didiglobal.com%2Fpaga-despues%2Flanding]
-> 品牌示例:
** 客户端 A: sheme://webview/load?target=https%3A%2F%2Fpay.merchant-b.com%2Fgateway%2Fcallback
expireTime String 过期时间 选填 支付链接的过期时间。
- 业务逻辑：如果用户在该时间戳之前未点击“确认支付”，订单将自动过期。
- 兜底策略：若该字段留空或未传入，滴滴将根据系统配置自动计算过期时间，计算方式为当前时间加 N 小时。
- 格式与时区：采用 ISO 8601 标准格式 yyyy-MM-dd'T'HH:mm:ss.SSSXXX，时区偏移为必填项。
- 示例：2025-12-08T01:11:33.000-06:00
currency String 货币 必填 墨西哥比索
test Boolean 测试订单备注标志。 选填 该字段为测试订单备注标记。
****** 测试环境**
对于测试 环境，该值应为以下内容之一：
  • 不存在：该字段不存在。

  • true：这是一笔测试交易。效果等同于该字段为空。


后续将不会进行对账，滴滴也不会向客户结算资金。
****** 生产环境**
针对生产环境，该字段仅能取以下值之一：
  • 不存在：该字段不存在。这是一笔生产环境下的正常交易。

  • false：这是一笔生产环境下的正常交易。

  • true： 这是一个 生产环境中的测试交易。该交易不会被结算，也不会被纳入对账文件中。
extendInfo Object 扩展信息 必填
deviceInfo 必填
deviceId String 设备ID 条件性 用于反欺诈与信用风险评估的设备标识符。
  • 业务逻辑：

  • 如果 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 中的 创建支付订单 应用程序编程接口。
partnerPhone String 用户手机号码 必填 该字段为必填项，字段信息应满足：
1. 最优场景：用户上次登录时使用的手机号码： 这是你能提供的最优质、最便捷的信息。

2. 备选方案：用户更改绑定手机号时输入的手机号码。

3. 最低要求方案：用户注册时最初提供的手机号码： 若该手机号码已变更，请为滴滴更新为新号码。

该手机号码是先买后付（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
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 Paga Después 将通过查询接口和订单回调提供该信息
JSON 格式

请求示例

{
  "partnerUid": "01213121131",
  "partnerOrderId": "ea7ed173-xxxx-11ef-b32d-ca3c6358d263",
  "orderCreateTime": "2026-06-30T14:30:15.123-06:00",
  "partnerOrderAmount": 5000,
  "redirectUrl": "<https://www.merchant.com/h5/orderInfo/index.html>",
  "redirectAppLink": "clientA://one/webpage?weburl=https%3A%2F%2Fapi.merchant-a.com%2Fcheckout%2Fresult",
  "expireTime": "2026-06-30T18:30:15.000-06:00",
  "currency": "MXN",
  "test": true,
  "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 内容类型 application/json 必填

Response Body

字段名称 类型 字段说明 展示 (必填​**/选填/条件性)** 备注
code String 返回码 必填 枚举值：
SUCCESS
FAILED
RATE_LIMIT
INVALID_TOKEN
message String 响应码描述 必填
data Object 响应数据 选填
orderId String 订单编号 必填 DiDi 先享后付 平台侧生成
partnerUid String 商户端用户ID 必填
partnerOrderId String 商户端支付单据ID 必填
applyLoanId String 申请贷款ID 选填 DiDi Paga Después 端信贷核心系统中的贷款ID
partnerOrderAmount Long 订单金额 必填 实际支付金额乘以100；该金额为应用商家折扣后的最终金额
金额单位为分。例如，若金额为99.99比索，此处的值应为9999。
currency String 币种 必填 ISO 4217 标准
墨西哥比索
orderStatus String 订单状态 必填 枚举：
INIT ：初始化
PENDING：待处理
PAYING：支付中
PAID：已支付
CANCELED: 已取消
已过期: 已过期
已拒绝: 已驳回
rejectCode String 拒绝码 选填 值已在已拒绝状态中存在
枚举：
GeneralError——内部错误
PaylaterRuleRejected——被先享后付规则拒绝
RiskRuleRejected——被风控规则拒绝
OverdueRepayment——用户存在逾期还款记录
CreditNotEnough——信用额度不足
PaylaterRuleDissatisfy——不满足先享后付规则要求
RiskControlRejected——被风控系统拒绝
TradePayFail——支付消费失败
rejectMsg String 拒绝原因 选填 值已处于拒绝状态
redirectUrl String 重定向 URL 必填 在滴滴先享后付页面完成支付操作后，无论支付成功还是失败，系统都会解析并返回该URL。
这主要是页面之间的交互流程。
它不会验证该 URL 是否可以跳转。
redirectAppLink String 应用重定向链接 选填
fuid Long DiDi Paga Después金融会员体系用户ID 选填
metadata String 元数据信息 选填 DiDi Paga Después 将通过查询和订单回调提供该信息
JSON 格式
paymentEntryUrl String 跳转至滴滴先享后付 H5 支付页面的 URL 选填
expireTime String 该订单的过期时间 选填 pattern:yyyy-MM-dd'T'HH:mm:ss.SSSXXX
例如：'2025-12-08T01:11:33.000+08:00'。时区偏移为必填项。
finishTime String 完成时间 选填 pattern:yyyy-MM-dd'T'HH:mm:ss.SSSXXX
例如：'2025-12-08T01:11:33.000+08:00'。时区偏移为必填项。
createTime String 订单创建时间 选填 pattern:yyyy-MM-dd'T'HH:mm:ss.SSSXXX
例如：'2025-12-08T01:11:33.000+08:00'。时区偏移为必填项。
updateTime String 订单状态最新更新时间 选填 pattern:yyyy-MM-dd'T'HH:mm:ss.SSSXXX
例如：'2025-12-08T01:11:33.000+08:00'。时区偏移为必填项。
orderCreateTime String 商户端订单创建时间 选填 pattern:yyyy-MM-dd'T'HH:mm:ss.SSSXXX
墨西哥城时区
例如：'2025-12-08T01:11:33.000+08:00'。时区偏移为必填项。
test Boolean 测试表单标签 选填
error Object 错误 选填
errorCode String 错误码 选填
errorMessage String 错误码描述 选填

响应示例

{
    "code": "SUCCESS",
    "message": "SUCCESS",
    "data": {
        "orderId": "189d141e-xxxx-11ef-b32d-ca3c6358d263",
        "partnerUid": "01213121131",
        "partnerOrderId": "1e1e51a8-xxxx-11ef-b32d-ca3c6358d263",
        "partnerOrderAmount": 5000,
        "currency": "MXN",
        "orderStatus": "PENDING",
        "redirectUrl": "<https://www.merchant.com/h5/orderInfo/index.html>",
        "redirectAppLink": "clientA://one/webpage?weburl=https%3A%2F%2Fapi.merchant-a.com%2Fcheckout%2Fresult",
        "fuid": 1231413141,
        "metadata": "{}",
        "paymentEntryUrl": "<https://pay.didiglobal.com/global-bnpl/kyc/?credit_type=full&fuid=1231413141&orderId=189d141e-8d38-11ef-b32d-ca3c6358d263>",
        "expireTime": "2026-06-30T18:26:00.000-06:00",
        "finishTime": null,
        "createTime": "2026-06-30T16:30:39.000-06:00",
        "updateTime": "2026-06-30T16:30:39.000-06:00",
        "orderCreateTime": "2026-06-30T14:30:39.000-06:00",
        "test": true
    },
    "error": null
}
复制成功