Skip to content
请求示例json
{
  "timestamp": "1728609257212",
  "platformOrderNo": "bdpay8q2m4x7c1n9",
  "trxId": "11111111"
}
200json
{
  "message": "success",
  "code": "00000",
  "timestamp": 1728609277476,
  "success": true,
  "data": true
}

TrxID 提交 ​

H2H 收款完成后,提交用户在钱包侧产生的交易 ID。

POST/api/v2/pay/trxid/submit

用于在订单创建后补充提交用户交易 ID,以便平台继续处理和判定结果。

使用说明 ​

  • H2H 模式下,通常需要先调用收款接口创建订单,再调用本接口补充用户交易 ID。
  • 用户完成支付后,需要在收银台页面或商户侧收集并提交 trxId。

TIP

您可以使用 code 参数判断受理状态:

  • code = 00000:提交成功,请等待后续回调或查单获取最终结果。
  • 其他任何 code 值:请求未成功受理,请按错误原因处理。

请求头 ​

x-access-keystring必选

商户访问标识

signaturestring必选

请求签名

请求参数 ​

timestampstring必选

毫秒级时间戳字符串,例如:1715941383720

platformOrderNostring必选

唯一平台订单号

trxIdstring必选

用户交易 ID

响应参数 ​

messagestring必返

请求结果。返回 success 仅表示请求已受理,不可做商户端逻辑判断

codestring必返

业务状态码。00000 表示请求受理成功,其他 5 位数字表示具体错误原因,请参考错误码页

timestampstring必返

交易时间

successboolean必返

接口调用结果

databoolean必返

提交结果。true 表示已成功提交

失败示例 ​

json
{
  "message": "Transaction not found",
  "code": "40401",
  "timestamp": 1728609277476,
  "success": false,
  "data": null
}