H Honor
ZH
DiDi finanzas

文档中心

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

2.5 Payment Order Query

2.5 Payment Order Query 支付订单信息查询

  • Path： /external/order/queryByPartnerOrderId/v1

  • Method: POST

  • API 说明：这是供合作方查询支付订单信息、尤其是订单状态的接口。

  • 使用说明：有时 支付订单信息查询 接口可能会因某些不可预知的原因返回错误。合作方不应将查询接口返回的错误视为 支付订单结果。合作方应将查询接口返回的具体结果作为 支付订单结果。

  • 补充说明：尽管滴滴会向合作方推送 Webhook ，但查询接口属于强制要求使用的能力。这是一项兜底（保障）策略，用于合作方在 Webhook 推送失败时自行获取 订单状态 。

Request Message

Request Headers

字段名称 字段说明 参数值 展示 (必填​**/选填/条件性)** 备注
Content-Type 内容类型 application/json 必填
Authorization 这是合作伙伴的身份认证值。 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

字段名称 类型 字段说明 展示 (必填​**/选填/条件性)** 备注
partnerOrderId String 商户侧支付单据ID 必填 幂等键
商户支付流水号ID

请求示例

{
    "partnerOrderId": "1e1e51a8-8d38-11ef-b32d-ca3c6358d263"
}

Response Message

Response Header

字段名称 字段描述 参数值 展示 (必填​**/选填/条件性)** 备注
Content-Type 内容类型 application/json 必填

Response Body

字段名称 类型 字段说明 展示 (必填​**/选填/条件性)** 备注
code String 返回码 必填 枚举值：
SUCCESS
FAILED
RATE_LIMIT
INVALID_TOKEN
message String 响应码描述 必填
data Object 支付订单数据 选填
orderId String 订单ID 必填 DiDi Paga Después 端生成
partnerOrderId String 商户侧支付单据ID 必填
partnerUid String 商户侧用户ID 必填
applyLoanId String 申请贷款编号 选填 DiDi Paga Después端信贷核心系统中的贷款ID
partnerOrderAmount Long 订单金额 必填 实际支付金额乘以100；该金额是应用商家折扣后的最终金额。
金额单位为分。例如，若金额为99.99比索，此处的值应为9999。
currency String 货币 必填 ISO 4217 标准
墨西哥比索
orderStatus String 订单状态 必填 枚举：
INIT-初始化 PENDING-待处理 PAYING-支付中 PAID-已支付 CANCELED-已取消 EXPIRED-已过期 DENIED-已驳回
rejectCode String 拒绝码 选填 该值已存在于已拒绝状态中
枚举：
GeneralError——内部错误
PaylaterRuleRejected——被先享后付规则拒绝
RiskRuleRejected——被风控规则拒绝
OverdueRepayment——用户存在逾期还款记录
CreditNotEnough——信用额度不足
PaylaterRuleDissatisfy——不符合先享后付的规则要求
RiskControlRejected–被风控拒绝
TradePayFail-消费失败
rejectMsg String 拒绝原因 选填 值已处于拒绝状态
redirectUrl String 重定向地址 必填 用户在滴滴先享后付页面完成支付操作后，无论支付成功或失败，该URL都将被解析并返回。
这主要是页面与页面之间的交互场景。
系统不会校验该URL是否能够正常跳转。
redirectAppLink String 应用跳转链接 必填 App 调用：合作方必须传入 redirectAppLink 在支付请求中。
fuid Long DiDi Paga Después 金融会员领域用户ID 选填
metadata String 元数据信息 选填 DiDi Paga Después 将通过查询接口和订单回调提供该信息。
JSON格式
paymentEntryUrl String 跳转至DiDi Paga Después H5支付页面的链接 选填
expireTime String 该订单的过期时间 选填 格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX
例如：'2025-12-08T01:11:33.000+08:00'。时区偏移为必填项。
finishTime String 完成时间 选填 格式：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-8d38-11ef-b32d-ca3c6358d263",
        "partnerOrderId": "1e1e51a8-8d38-11ef-b32d-ca3c6358d263",
        "partnerUid": "01213121131",
        "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-10-14T18:26:00.000-06:00",
        "finishTime": null,
        "createTime": "2026-10-14T02:30:39.000-06:00",
        "updateTime": "2026-10-14T02:30:39.000-06:00",
        "orderCreateTime": "2026-10-14T02:30:39.000-06:00",
        "test": true
    },
    "error": null
}
复制成功