提交 UTR

POST /v1/api/collection/submitted_utr

• 这是提交付款参考号并验证的接口，不是普通查单；验证成功后可触发成功回调。
• 失败可返回 code=100503，HTTP 200；不要仅按 HTTP 状态判断。

请求参数

字段	类型	要求	说明
tenant_id	string	必填	商户编号，须与 app_key 属于同一商户；最多 20 字符。
app_key	string	必填	商户应用标识，最多 16 字符；使用该应用对应的 app_secret 签名。
timestamp	string / integer	必填	当前 Unix 秒级时间戳。超过 60 秒的旧时间戳会被拒绝；不要传毫秒。
sign	string	必填	按签名规则计算的 32 位小写 MD5。
platform_order_no	string	必填	平台订单号，最多 30 字符。
customer_submitted_utr	string	必填	客户提交的支付参考号，最多 20 字符。

签名计算见签名规则。

请求示例 · cURL

curl --request POST 'https://api.trpay2024.com/v1/api/collection/submitted_utr' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tenant_id": "DEMO0001",
  "app_key": "demo_app_key",
  "timestamp": "1791199800",
  "platform_order_no": "CRT202610051700DEMO0001",
  "customer_submitted_utr": "123456789012",
  "sign": "352329327a6cc5ca0e302097d583eded"
}'

响应示例

{
  "request_id": "00000000-0000-4000-8000-000000000001",
  "path": "/v1/api/collection/submitted_utr",
  "success": true,
  "code": 200,
  "message": "成功",
  "data": {
    "orderId": "DEMO-PAYIN-001",
    "orderAmount": 500.07,
    "utr": "123456789012"
  }
}

data 字段

字段	类型	要求	说明
orderId	string	必填	商户订单号。
orderAmount	number	必填	有实付金额时返回实付，否则返回订单金额。
utr	string	必填	付款参考号。

异常处理

请参阅HTTP 处理、请求异常处理和错误码。