Onerway
POST

Transfer Callback

View as Markdown
Webhook URL
Receive asynchronous callbacks when the transfer status changes and update your business order accordingly.

Webhook payload fields

merchantNostring
Merchant number assigned by Onerway.
requestIdstring
Merchant request ID used to correlate this notification with your business order.
payoutIdstring
Onerway payout ID for this transfer.
Constraints
Rule
This value can exceed JavaScript safe-integer range. Preserve it as a string when storing or comparing it.
statusstring
Current transfer status.
Allowed values
A
Pending review.
CA
Under compliance review.
B
Pending system check.
Constraints
Rule
Use this field as the transfer lifecycle status. Treat S as success and F as final failure; intermediate values indicate that processing is still continuing or awaiting review.
statusTimestring
Time when this status was generated, in yyyy-MM-dd HH:mm:ss format.
payoutStatusReasonstring
Additional reason text for the current transfer status.
settleCurrencystring
Settlement currency used for the payout request.
settleSumAmountnumber
Settlement amount submitted for this payout.
payoutCurrencystring
Beneficiary receive currency.
payoutAmountnumber
Amount received by the beneficiary in payoutCurrency.
serviceFeenumber
Service fee charged for this payout.
convRatenumber
Conversion rate used for this payout.

Webhook example

{
  "merchantNo": "replace_with_merchant_no",
  "requestId": "replace_with_request_id",
  "payoutId": "replace_with_payout_id",
  "status": "P",
  "statusTime": "2025-01-15 08:32:10",
  "payoutStatusReason": "Submitted to downstream payout channel",
  "settleCurrency": "USD",
  "settleSumAmount": 100,
  "payoutCurrency": "EUR",
  "payoutAmount": 92.35,
  "serviceFee": 2.5,
  "convRate": 0.9235
}

Acknowledgement

Return HTTP 200 with a plain-text body of SUCCESS after the notification is received and processed successfully.

Response body example

HTTP 200
Return the exact success string expected by the legacy transfer webhook.
SUCCESS

FX Rate Query

Query the indicative FX rate from a source currency to a target currency.

Enumeration Descriptions

Review common Transfer response codes, transfer status values, and related enum dictionaries.