Initiate Refund

Developing

Sandbox Env

POST

/v1/txn/onlineRefund

Request

Body Params application/json

merchantNo

enum<string>

商户号

required

Merchant Number

Allowed value:

merchantTxnId

string

商户创建的交易订单号

required

Merchant Transaction ID

originTransactionId

enum<string>

来源于Onerway的原始交易订单号

required

Original Transaction Id

Allowed value:

refundAmount

enum<string>

退款金额

required

Amount to be refunded

Allowed value:

refundType

enum<string>

退款类型

required

Type of refund (e.g.

Allowed value:

sign

null

签名

required

Signature string for request verification

Example

{
  "merchantNo": "{{MERCHANT-NO}}",
  "merchantTxnId": "R-2d385c13-436d-4e24-8a18-c5ec202c1363",
  "originTransactionId": "{{TRANSACTION-TO-REFUND}}",
  "refundAmount": "{{REFUND-AMOUNT}}",
  "refundType": "0",
  "sign": null
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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-2d385c13-436d-4e24-8a18-c5ec202c1363",
    "originTransactionId": "{{TRANSACTION-TO-REFUND}}",
    "refundAmount": "{{REFUND-AMOUNT}}",
    "refundType": "0",
    "sign": null
}'

Responses

🟢200OK

application/json

Body

object {0}

Example

{}

Modified at 2025-03-26 10:20:31

Peru-PagoEfectivo

Cancel Refund