POST
更新 SDK 订单
该接口用于在客户确认支付前,更新 SDK 交易的订单金额、账单信息或配送信息。
请求
billingInformation{ email, country, ... }更新后的交易账单信息,包含客户账单地址和联系信息。仅在账单信息需要变更时传入;已包含的字段会覆盖原交易中的对应值,对象内部字段原有的必填条件仍然生效。
约束
- 规则
- 不要用
null或空字符串覆盖已有信息;不需要变更的字段直接省略。
merchantTxnId条件:
要更新订单的商户交易标识,必须与原下单请求中提交的 merchantTxnId 与 transactionId 至少提供一个。merchantTxnId 一致。示例:
example_sdk_txn_001约束
- 一致性
- 同时传入
merchantTxnId和transactionId时,两者必须指向同一笔原始交易。
newMerchantTxnId用于替换原订单
merchantTxnId 的新商户交易标识。不修改商户交易标识时省略;更新成功后,后续请求应使用新的标识。shippingInformation{ email, country, ... }更新后的交易配送信息,包含客户配送地址和联系信息。仅在配送信息需要变更时传入;已包含的字段会覆盖原交易中的对应值,对象内部字段原有的必填条件仍然生效。
约束
- 规则
- 不要用
null或空字符串覆盖已有信息;不需要变更的字段直接省略。
sign请求签名字符串;生成方式详见请求签名。
transactionId条件:
要更新订单的 Onerway 交易标识,必须与原下单响应返回的 transactionId 与 merchantTxnId 至少提供一个。transactionId 一致。示例:
example_transaction_id_update约束
- 一致性
- 同时传入
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响应码对应的可读说明。
data{ transactionId, responseTime, ... }更新订单确认响应的业务数据对象。成功响应只表示订单更新已受理,不代表支付结果;最终支付状态以服务端支付 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"
}
}该接口暂未记录错误响应。