Refund API

Ask AI

Endpoint contract

Initiate a refund for a completed transaction.

POST /v2/refundapplication/jsonSignature required

Request

Field	Type	Required	Description
transactionId	String (ULID)	M	The original GLODIPAY transaction ID.
amount	Float	M	Refund amount. Minimum 0.10 and capped by the remaining refundable amount.
reason	String(max:1000)	O	Short refund reason.
signature	String(max:750)	M	RSA-MD5 signature.

Response

A successful response returns status, message, and a data object containing refundId and refundNumber. Validation errors return HTTP 422 with status: error and an errors array.

Auto-processed refund: message is null.

Pending approval: message is "Refund created and waiting for approval."

Note: Certain providers (PayAgency, SmartPay, ClisaPay, FinvyPay, WPay) only support full-amount refunds. The gateway enforces the minimum refund amount accordingly.

Refund status updates are delivered to the original transaction webhook URL and must be acknowledged with {"returnCode":"100"} within 30 seconds.

Source

This page is derived from Refund API.