Onerway
POST

更新 SDK 订单

该接口用于在客户确认支付前,更新 SDK 交易的订单金额、账单信息或配送信息。

请求

更新后的交易账单信息,包含客户账单地址和联系信息。仅在账单信息需要变更时传入;已包含的字段会覆盖原交易中的对应值,对象内部字段原有的必填条件仍然生效。
约束
规则
不要用 null 或空字符串覆盖已有信息;不需要变更的字段直接省略。
merchantNo
Onerway 分配的商户号;获取方式参见接入准备。
示例:
merchantTxnId
条件:merchantTxnId 与 transactionId 至少提供一个。
要更新订单的商户交易标识,必须与原下单请求中提交的 merchantTxnId 一致。
示例:
约束
一致性
同时传入 merchantTxnId 和 transactionId 时,两者必须指向同一笔原始交易。
newMerchantTxnId
用于替换原订单 merchantTxnId 的新商户交易标识。不修改商户交易标识时省略;更新成功后,后续请求应使用新的标识。
orderAmount
当前订单金额,以原交易币种计价,使用十进制字符串。格式要求详见币种与金额校验。
示例:
约束
规则
始终必填。即使只更新账单或配送信息,也必须重复提交当前订单金额。
更新后的交易配送信息,包含客户配送地址和联系信息。仅在配送信息需要变更时传入;已包含的字段会覆盖原交易中的对应值,对象内部字段原有的必填条件仍然生效。
约束
规则
不要用 null 或空字符串覆盖已有信息;不需要变更的字段直接省略。
sign
请求签名字符串;生成方式详见请求签名。
transactionId
条件:transactionId 与 merchantTxnId 至少提供一个。
要更新订单的 Onerway 交易标识,必须与原下单响应返回的 transactionId 一致。
示例:
约束
一致性
同时传入 transactionId 和 merchantTxnId 时,两者必须指向同一笔原始交易。

请求示例

curl -X POST 'https://sandbox-acq.onerway.com/v1/sdkTxn/updateOrder' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "merchantNo": "replace_with_merchant_no",
  "orderAmount": "25.00",
  "sign": "replace_with_calculated_signature",
  "transactionId": "example_transaction_id_update"
}'

响应

respCode
响应码;20000 表示请求处理成功,其余为错误码。完整码表见响应码。
respMsg
响应码对应的可读说明。
更新订单确认响应的业务数据对象。成功响应只表示订单更新已受理,不代表支付结果;最终支付状态以服务端支付 Webhook 或交易查询为准。

响应示例

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "transactionId": "example_transaction_id_update",
    "responseTime": null,
    "txnTime": null,
    "txnTimeZone": null,
    "orderAmount": null,
    "orderCurrency": null,
    "txnAmount": null,
    "txnCurrency": null,
    "status": null,
    "redirectUrl": null,
    "contractId": null,
    "tokenId": null,
    "eci": null,
    "periodValue": null,
    "codeForm": null,
    "presentContext": null,
    "actionType": null,
    "subscriptionManageUrl": null,
    "sign": "replace_with_response_signature"
  }
}
该接口暂未记录错误响应。