订单查询接口

📌 Overview

该接口用于查询商户订单详情。需在请求路径中传入订单唯一标识ID ，该id由《payment》支付结果返回。

Endpoint

POST /payment/payments/{id}

请求示例

curl --location --request POST 'http://localhost:9999payment/payments/P251011143910228479127' \
--header 'tenant-id: 220818025875' \
--header 'Request-Time: 1760331085541' \
--header 'Signature: algorithm=MD5,keyVersion=1,signature=cb00b60f9f24483d56532e3c2d5d8de4'

返回响应

顶层结构字段说明

字段	类型	示例值	说明
requestId	string	75daa341-66fd-4d87-949b-28f7f0ef6d64	本次通知的唯一追踪 ID，由服务端生成，用于日志追踪、链路排查与问题定位。每次通知通常唯一。
success	boolean	true	表示本次接口调用是否成功（接口层面）。true 表示通知调用成功并已返回业务结果；false 表示接口调用异常，如签名错误、参数缺失、权限拒绝、通道关闭等。
data	object	{...}	支付结果详情对象。当 success = true 时，商户应重点解析该对象中的业务字段。
timestamp	string (ISO 8601)	2025-10-10T16:39:23.765+08:00	通知生成时间，采用 ISO 8601 标准格式，包含毫秒与时区偏移。

data 对象字段说明（支付结果详情）

字段	类型	示例值	说明
id	string	P1231823	IntPay 平台交易号。用于标识平台侧唯一交易，可用于对账、查询与问题排查。
reference	string	SAIDF01239-1230	商户订单号或交易参考号，由商户系统生成，用于关联商户内部订单。
requiresAction	boolean	false	是否仍需用户执行额外操作。通常用于表示是否需要完成额外验证步骤（如 3DS、OTP 等）。
amount	number	100	支付金额，单位为最小货币单位。例如 USD 下 100 表示 1.00 USD。
currency	string	USD	支付币种，遵循 ISO 4217 三位字母代码标准。
failureMessage	string	fail	失败原因描述。当交易失败时返回；成功状态下通常为空、为 null 或被省略。
status	string	FAILED	当前订单状态枚举值，商户应以此字段作为订单状态更新依据。

响应示例

付款成功

{
    "requestId": "b5cb20f9-6968-41ff-8e53-b1a9fc87a2b8",
    "success": true,
    "data": {
        "id": "P251011144163273295845",
        "reference": "R202512038",
        "status": "SUCCESS",
        "amount": 10000,
        "currency": "USD",
        "requiresAction": null,
        "nextAction": null,
        "failureMessage": null
    },
    "timestamp": "2025-10-11T14:41:23.406+08:00"
}

付款失败

{
    "requestId": "75daa341-66fd-4d87-949b-28f7f0ef6d64",
    "success": true,
    "data": {
        "reference": "SAIDF01239-1230",
        "requiresAction": false,
        "amount": 100,
        "currency": "USD",
        "id": "P1231823",
        "failureMessage": "Your card was declined. Please check with your bank or use a different card.",
        "status": "FAILED"
    },
    "timestamp": "2025-10-10T16:39:23.765+08:00"
}