Guides

Refund

Returns funds on a transaction that has already settled. Omit amount for a full refund, or send a smaller value for a partial refund. For unsettled transactions, use Void instead.

Request

# Full refund
curl '{gtw_url}/locations/{location_id}/transactions/{transaction_id}/refund' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{}'

# Partial refund ($2.50)
curl '{gtw_url}/locations/{location_id}/transactions/{transaction_id}/refund' \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{ "amount": 2.50 }'

transaction_id goes in the path. Optional amount is in major units; partial refunds can't exceed the settled amount.

Response — 200 OK

{ "transaction_id": "F8B411EF-DF50-04AE-A9F6-D05099D6021D", "amount_approved": 250 }

amount_approved is in cents.

→ Full field reference: Refund