Refund a Sale
Create a Refund transaction from a previous Sale. The payment method associated with the original Sale is used to refund the Payer. If the amount is not specified in the refund request, the full amount of the Sale will be refunded. Availability of this feature in production depends on your allowed live configuration. Please contact Global Payments before coding this feature to confirm it will be available to you when you go live.
Authorization
bearerAuth Access token from POST /accesstoken, sent as Authorization: Bearer <token>.
In: header
Path Parameters
A unique identifier that is used to identify and reference an instance of this resource. It is generated by Global Payments to identify the transaction and must be used to action that transaction in future.
1 <= length <= 50Header Parameters
Integrator generated value submitted in the request header that is checked to ensure the same value has not been seen in the last 24 hours. It is used to ensure idempotency is maintained with this action.
1 <= length <= 50The version of the API to execute the request.
1 <= length <= 50"2021-03-22"Request Body
application/json
The amount to transfer between Payer and Merchant for a SALE or a REFUND. It is always represented in the lowest denomination of the related currency. and with no decimal point.
1 <= length <= 50The amount of the gratuity for a transaction.
1 <= length <= 50The total amount of tax charges associated with this transaction.
1 <= length <= 50Merchant defined field to reference the transaction.
8 <= length <= 50The amount that reflects the additional charge the merchant applied to the transaction for using a specific payment method.
1 <= length <= 50Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/transactions/TRN_uzFr7t4VOqxdLDI44hHmXIjHtOOE8d/refund" \ -H "X-GP-Version: 2021-03-22" \ -H "Content-Type: application/json" \ -d '{ "amount": "1199" }'{ "id": "TRN_PARiD8CqLufPVm6xg5B6QEyvJ40qes", "time_created": "2026-02-13T11:30:51.221Z", "time_last_updated": "2026-02-13T11:30:51.221Z", "type": "REFUND", "status": "CAPTURED", "amount": "1500", "gratuity_amount": "20", "tax_amount": "2", "surcharge_amount": "0", "currency": "USD", "country": "US", "reference": "TRANS-20210114123459948", "payment_method": { "result": "A0014", "message": "Return requested, Void successful", "card": { "authcode": "TAS153", "brand_reference": "12234" } }, "order": { "duty_amount": "300", "shipping_amount": "250", "taxes": [ { "amount": "200", "type": "VAT", "percentage": "18" } ] }, "batch_id": "BAT_88800013479401", "action": { "id": "ACT_PARiD8CqLufPVm6xg5B6QEyvJ40qes", "type": "REFUND", "time_created": "2026-02-13T11:30:51.221Z", "result_code": "SUCCESS", "app_id": "VuT4qLPs98hwVMnGAPkWz3KDIuAumlwz", "app_name": "demo_transit_app" }}Get a Transaction GET
Get a single view of a transaction using the transaction id. Availability of this feature in production depends on your allowed live configuration. Please contact Global Payments before coding this feature to confirm it will be available to you when you go live.
Reverse a Sale or Refund POST
Cancel a transaction before funds are exchanged. Transactions can be reversed in full or partially reversed. An attempt to restore Payer's spending limit is always made. If no amount is included in the request body, the full value of the transaction will be reversed. In timeout scenarios, where the integrator does not recieve a response at all, the reference field can be used in place of the id in the URL Availability of partial reversals depends on your live configuration.