Refund a payment

Refunds a successful transaction, fully or partially.

POSThttps://pay.syok2pay-sandbox.com/v1/refund

Base URL

https://pay.syok2pay-sandbox.com

Request body

merchant_coderequired

string

Your merchant code

reference_norequired

string

Unique refund reference

original_reference_norequired

string

Reference of the original payment

refund_amount

string

Decimal string, 2 dp. Omit or 0 for a full refund.

currency

string

ISO code, e.g. MYR

reason

string

Refund reason

Example response

json

{
  "success": true,
  "data": {
    "reference_no": "RFN-20260428-001",
    "txn_id": "txn_abc123",
    "txn_status": "REFUNDED",
    "refund_amount": "1.00"
  },
  "trace_id": "xid_abc123"
}

// representative — data fields are the processor passthrough