Onerway
POST

预授权请款与撤销

该接口用于对成功的预授权发起全额请款,或撤销预授权以释放冻结金额。

请求

merchantNo
Onerway 分配的商户号;获取方式参见接入准备。
示例:
txnType
要执行的授权后操作类型,决定本次调用是请款还是撤销。
可选值
CAPTURE
预授权请款:对此前成功的预授权发起请款,扣划已冻结的全部金额;仅支持全额请款。
VOID
预授权撤销:撤销此前的预授权,释放冻结金额、不扣款。
merchantTxnId
本次请款 / 撤销操作的商户交易订单号;不同订单号视为不同交易。
示例:
originTransactionId
原预授权交易订单号(Onerway 侧返回的交易号),用于定位被请款 / 撤销的预授权交易。
示例:
sign
请求签名字符串;生成方式详见请求签名。

请求示例

curl -X POST 'https://sandbox-acq.onerway.com/v1/txn/authPayment' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "merchantNo": "replace_with_merchant_no",
  "merchantTxnId": "txn_demo_capture_202606210001",
  "originTransactionId": "example_original_auth_transaction_id",
  "sign": "{{SIGN}}",
  "txnType": "CAPTURE"
}'

响应

respCode
响应码;20000 表示请求处理成功,其余为错误码。完整码表见响应码。
respMsg
响应码对应的可读消息。
业务数据对象,承载本次请款 / 撤销操作的处理结果与交易字段。

响应示例

示例代码暂不可用。

该接口暂未记录错误响应。