Onerway
POST

Transfer Voucher Query

Query and download the electronic voucher for a successful transfer.

Request

merchantNo
Merchant number assigned by Onerway. Retrieve it from the merchant portal or onboarding material after your sandbox or production account is created.
Example:
requestId
Condition: Required when payoutId is not provided.
Merchant request ID used to look up the voucher.
payoutId
Condition: Required when requestId is not provided.
Onerway payout ID used to look up the voucher.
sign
Request signature string. Generate it according to the Transfer request-signing rules with your merchant private key.

Request example

curl -X POST 'https://sandbox-api.onerway.com/payout/api/v1/txn/queryVoucher' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "merchantNo": "801129",
  "payoutId": "1984136974445449216",
  "sign": "{{SIGN}}"
}'

Response

respCode
Response code returned by Onerway.
respMsg
Response message returned by Onerway.
Voucher download result.

Response example

{
  "respCode": "20000",
  "respMsg": null,
  "data": {
    "requestId": "CYPW20251031055450",
    "payoutId": "1984136974445449216",
    "voucherUrl": "https://example.com/vouchers/1984136974445449216.pdf"
  }
}
No error responses are documented for this endpoint.