Onerway Payment API
Onerway APIs
  1. Refund
  • Onerway 商户 API 接入指南
  • Onerway Merchant API Testing
  • Payment APIs
    • Checkout
      • Card Checkout
      • Card Checkout - Subscribe
      • APMs Checkout
      • Single-Method APM Checkout
      • Card Checkout - Authorizaiton
    • JS-SDK
      • One-Time Payment Intent
      • Subscription Payment Intent
      • Card Tokenization Intent
    • API
      • Card
      • Pre-Auth
      • Auth Reversal
      • Capture
      • Card Tokenization
      • Tokenized Payment
      • Subscription - Charge by Onerway
      • Subscription Initial Charge
      • Subscription Recurring Charge
      • Subscription Cancellation
      • Subscription Reactivation
      • Token Removal
    • APMs - Alternative Payment Methods
      • Thailand
        • Thailand-TrueMoney Wallet
        • Thailand-PromptPay
        • Thailand-Rabbit_Line_pay
        • Thailand-KRUNGSRI_ONLINE
      • Malaysia
        • Malaysia-TOUCH_GO_EWALLET
        • Malaysia-Boost
        • Malaysia-MCASH
        • Malaysia-ShopeePay
        • Malaysia-FPX
      • Indonesia
        • Indonesia-ShopeePay
        • Indonesia-OVO
        • Indonesia-DANA
        • Indonesia-QRIS
        • Indonesia-BNI
        • Indonesia-MANDIRI
        • Indonesia-Maybank
        • Indonesia-PERMATA
        • Indonesia-BRI
        • Indonesia-CIMB
        • Indonesia-AKULAKU
        • Indonesia-DANA(Subscribe)
      • Japan
        • Japan-Konbini
        • Japan-PayEasy
      • South Korea
        • South Korea-Kakao_Pay
        • South Korea-Naver_Pay
        • South Korea-PAYCO
        • South Korea-Cards_KOR
      • Vietnam
        • Vietnam-NINE_PAY
        • Vietnam-PAYME
        • Vietnam-VIET_QR
        • Vietnam-MOMO
        • Vietnam-ATM_CARD
      • Philippines
        • Philippines-Dragonpay
        • Philippines-QR_PH
      • Brazil
        • Brazil-Boleto
        • Brazil-Visa/Master
        • Brazil-PIX
        • Brazil-PicPay
        • Brazil-MercadoPago
      • Mexico
        • Mexico-Visa/Master
        • Mexico-SPEI
        • Mexico-OXXO
        • Mexico-PaySafeCard
      • Chile
        • Chile-Visa/Master
        • Chile-Khipu
        • Chile-Webpay
        • Chile-Servipag
        • Chile-Sencillito
      • Paraguay
        • Paraguay-Visa/Master
        • Paraguay-Infonet
      • United States
        • United States-PayPal
        • United States-Venmo
        • United States-CASH_APP
      • Belgium
        • Belgium-Bancontact
        • Belgium-Payconiq
      • Germany
        • Germany-PaySafeCard
        • Germany-Giropay
      • Italy
        • Italy-MyBank
      • Luxembourg
        • Luxembourg-Payconiq
      • Estonia
      • Turkey
        • Turkey-Papara
      • Peru
        • Peru-PagoEfectivo
    • Refund
      • Initiate Refund
        POST
      • Cancel Refund
        POST
    • Settlement
      • Settlement File Download
    • Query
      • Retrieve Transaction Orders
      • Query Installment Options
      • Retrieve Subscription Details
      • Query Chargeback Records
      • Retrieve Card Tokenization Records
    • Utils
      • Signature Validation Helper
  1. Refund

Initiate Refund

Developing
Sandbox Env
https://sandbox-acq.onerway.com
Sandbox Env
https://sandbox-acq.onerway.com
POST
/v1/txn/onlineRefund

Request

Body Params application/json
merchantNo
enum<string> 
商户号
required
Merchant Number
Allowed value:
{{MERCHANT-NO}}
merchantTxnId
string 
商户创建的交易订单号
required
Merchant Transaction ID
originTransactionId
enum<string> 
来源于Onerway的原始交易订单号
required
Original Transaction Id
Allowed value:
{{TRANSACTION-TO-REFUND}}
refundAmount
enum<string> 
退款金额
required
Amount to be refunded
Allowed value:
{{REFUND-AMOUNT}}
refundType
enum<string> 
退款类型
required
Type of refund (e.g.
Allowed value:
0
sign
null 
签名
required
Signature string for request verification
Example
{
    "merchantNo": "{{MERCHANT-NO}}",
    "merchantTxnId": "R-b20e9b40-4479-4ab7-aa40-69463f7dea45",
    "originTransactionId": "1925113619105058816",
    "refundAmount": "45",
    "refundType": "0",
    "sign": null
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sandbox-acq.onerway.com/v1/txn/onlineRefund' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchantNo": "YOUR-MERCHANT-NO",
    "merchantTxnId": "R-b20e9b40-4479-4ab7-aa40-69463f7dea45",
    "originTransactionId": "1925113619105058816",
    "refundAmount": "45",
    "refundType": "0",
    "sign": null
}'

Responses

🟢200OK
application/json
Body
object {0}
Example
{}
Modified at 2025-05-23 02:25:29
Previous
Peru-PagoEfectivo
Next
Cancel Refund
Built with