Refund

POST/pay/trade/refund

Submit a full or partial refund request for a paid order.

Bodyapplication/x-www-form-urlencoded

pay_memberidstringrequiredsign

Merchant ID.

transaction_idstringrequiredsign

Platform transaction ID.

pay_orderidstringrequiredsign

Merchant order number.

currencystringrequired

Order currency.

pay_amountstringrequired

Original order amount.

refund_amountstringrequired

Refund amount (supports partial refund).

refund_reasonstringrequired

Reason for the refund.

pay_md5signstringrequired

See MD5 signature algorithm

Response

memberidstring

Merchant ID assigned by the platform.

transaction_idstring

Platform transaction ID.

orderidstring

Merchant order ID.

currencystring

Order currency.

amountstring

Original order amount.

refund_orderidstring

Refund order ID. Returned when the refund request is accepted.

refund_amountstring

Refunded amount. Supports partial refunds.

refund_reasonstring

Refund reason submitted in the request.

returncodestring

Result code. "00" indicates success.

refund_messagestring

Refund status message: V0000:OK or V0011:ERROR.

signstring

See MD5 signature algorithm

POST/pay/trade/refund

Request example

curl

curl --request POST \
  --url https://sandbox.j-pay.net/pay/trade/refund \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data 'pay_memberid=10153&transaction_id=966782078392&pay_orderid=O2026060182255&currency=USD&pay_amount=1.00&refund_amount=1.00&refund_reason=customer%20request&pay_md5sign=YOUR_SIGN'

Response example

{
"memberid": "10153",
"transaction_id": "966782078392",
"orderid": "O2026060182255",
"currency": "USD",
"amount": "1.00",
"refund_orderid": "R20260601001",
"refund_amount": "1.00",
"refund_reason": "customer request",
"returncode": "00",
"refund_message": "V0000:OK",
"sign": "SIGN"
}