Onerway
GET

Download settlement file

Use this endpoint after Onerway has enabled settlement-file download permission for your account. Send the signed request parameters as headers and save successful responses as UTF-8 CSV files.

Request

merchantNo
Merchant number assigned by Onerway. See Setup for how to obtain it.
Example:
date
Settlement date for the file to download.
Example:
Constraints
Rule
Use yyyyMMdd format without hyphens; do not submit dates such as 2021-10-26.
currency
Three-letter ISO 4217 settlement currency code for the file to download.
Example:
sign
Request signature string. See Request signing for how to generate it.
Constraints
Rule
All request parameters for this endpoint are sent as headers; the sign header itself is excluded from its own signature calculation.

Request example

curl -X GET 'https://sandbox-acq.onerway.com/v1/settlementFile/download' \
  -H 'merchantNo: replace_with_merchant_no' \
  -H 'date: 20211026' \
  -H 'currency: USD' \
  -H 'sign: {{SIGN}}' \
  -H 'Content-Type: application/json' \
  --data-raw '{}'

Response

Successful responses return an application/octet-stream file stream, not a JSON body. Save the UTF-8 encoded content as a .csv file.

Response example

Example code is unavailable.

No error responses are documented for this endpoint.