Refund Transaction

Use this endpoint to request the refund of a paid transaction.

Available Environments

Production

https://api.gateway.com.br/core

Endpoint

• Method: POST
• Endpoint: /transaction/{id}/refund
• Authentication: Bearer token

Path Params

Name	Type	Required	Description	Validations
id	string (UUID)	Yes	Transaction identifier	Must be a valid UUID

Request Example

cURL

curl --request POST \
--url https://api.gateway.com.br/core/transaction/553e8400-e29b-41d4-a716-436251480000/refund \
--header 'Authorization: Bearer your-jwt-token'

JavaScript

const response = await fetch('https://api.gateway.com.br/core/transaction/553e8400-e29b-41d4-a716-436251480000/refund', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-jwt-token'
  }
});

const data = await response.json();

Success Response

Field	Type	Required	Description
id	string (UUID)	Yes	Transaction identifier
status	string (enum) - PROCESSING_REFUND	Yes	Refund in progress

Response Example

{
  "id": "553e8400-e29b-41d4-a716-436251480000",
  "status": "PROCESSING_REFUND"
}

Possible Errors

Code	Description	Solution
401	Invalid credentials	Check your credentials
403	No permission/authorization	Contact support
404	Record not found	Check the id you sent
422	Invalid or missing data	Check the format of the data
422	Validations	Contact support
500	Internal error	Contact support