Refunds API Reference Overview

📘
Read the Refund Guide and Tutorials

Refund payments guide

Refund

A refund reverses a previously successful PayIn. Refunds can be initiated from any channel (e.g., POS, merchant back-office/portal, customer support operations, or a direct API integration), as long as the original payment can be referenced.

High-level workflow

A merchant/operator initiates a refund request and provides the required identifiers for the original payment (e.g., transactionNo / reference) plus the refund details (full or partial refundAmount, currency, and any other required fields such as merchant/store identifiers).

The merchant system calls Pockyt’s refund endpoint, which validates the request and routes it to the underlying wallet/acquirer/provider to execute the reversal.

POST https://mapi.yuansfer.com/app-data-search/v3/refund

Once completed, the customer is reimbursed back to the original payment method / wallet funding source, and the customer may also receive a wallet notification. Refund status is also surfaced back to the merchant via the API response and/or webhooks/reporting (depending on your integration).