Onerway
POST

Refund result webhook

View as Markdown
Webhook URL
Receive refund results at the original transaction’s notifyUrl. Do not use the example to determine whether a field is always returned or can be null. See Webhooks for handling and Create or cancel refund for requests.

Signature coverage

Request signing guide

All payload fields are included in the signature except:

Webhook payload fields

notifyTypestring
Notification category.
transactionIdstring
Onerway refund transaction number. Return this value unchanged when acknowledging the notification.
paymentIdstring
Payment Intent ID associated with this refund.
txnTypestring
Transaction operation type. REFUND identifies a refund result.
merchantNostring
Merchant number assigned by Onerway.
merchantTxnIdstring
Merchant transaction number for the refund. Onerway generates it if omitted from the refund request.
originMerchantTxnIdstring
Merchant transaction number of the original payment.
responseTimestring
Time when Onerway generated the notification result, in yyyy-MM-dd HH:mm:ss format.
txnTimestring
Transaction time recorded in the notification, in yyyy-MM-dd HH:mm:ss format.
txnTimeZonestring
Time zone offset for the transaction times in the notification.
orderAmountstring
Transaction amount reported in this notification, expressed in orderCurrency as a decimal string.
orderCurrencystring
Currency of orderAmount.
statusstring
Refund processing result. S means success and F means failure.
cardBinCountrystring
Country or region associated with the card BIN.
reasonstring
Result details encoded as a JSON string containing respCode and respMsg. When verifying the signature, use the field value as received, without parsing or reserializing its JSON content.
signstringSignature field · Excluded from signature
Legacy body signature, excluded from the signature input. It uses only the first enabled key. Verify the notification using the signature in the X-Rh-Signature header.
paymentMethodstringExcluded from signature
Payment method or card brand reported in the notification. Exclude this field when calculating the signature.
walletTypeNamestringExcluded from signature
Wallet type reported in the notification. Exclude this field when calculating the signature.
channelRequestIdstring
Payment channel request identifier.
paymentMethodDetailsstring
Payment method details encoded as a JSON string. When verifying the signature, use the field value as received, without parsing or reserializing its JSON content.

Webhook example

{
  "notifyType": "TXN",
  "transactionId": "demo_transactionId",
  "paymentId": "demo_paymentId",
  "txnType": "REFUND",
  "merchantNo": "demo_merchantNo",
  "merchantTxnId": "demo_merchantTxnId",
  "originMerchantTxnId": "demo_originMerchantTxnId",
  "responseTime": "2026-09-14 00:05:29",
  "txnTime": "2026-09-14 00:05:28",
  "txnTimeZone": "+08:00",
  "orderAmount": "13.36",
  "orderCurrency": "USD",
  "status": "S",
  "cardBinCountry": "US",
  "reason": "{\"respCode\": \"20000\", \"respMsg\": \"Success\"}",
  "sign": "replace_with_signature",
  "paymentMethod": "VISA",
  "walletTypeName": "ApplePay",
  "channelRequestId": "demo_channelRequestId",
  "paymentMethodDetails": "{\"card\": {\"checks\": null, \"holderName\": null, \"year\": null, \"month\": null, \"cardType\": \"ApplePay\", \"productCategory\": null, \"issuer\": null, \"cardBinCountry\": \"US\", \"authorizationCode\": null, \"cardNumber\": \"[REDACTED]\"}}"
}

Acknowledgement

After receiving and accepting the notification, return HTTP 200 with Content-Type: text/plain and the received transactionId unchanged in the response body. Without a successful response, Onerway retries at 30-minute intervals, up to 3 times.

Response body example

HTTP 200
demo_transactionId

RDR enrollment status webhook

RDR enrollment status changes, payload fields, signature verification, and acknowledgement requirements.

Refund request rejection webhook

Sent to the original transaction’s notifyUrl only when Onerway rejects a refund request during review (notifyType=REFUND_AUDIT).