Refunds and cancellations
Refunds and cancellations are actions taken after a payment has been completed. Because they both involve the return of money, they may seem similar, but there are important differences between the two processes.
- Refund: is made after the payment is processed, and the amount will be credited directly to the statement in the case of a credit card, or to the payer's account when the payment is made by other means.
- Cancellation: is made when a payment has not yet been approved, and the limit is returned to the buyer's card within the timeframe defined by the issuing bank.
See below for more information on refunds and cancellations.
Refunds are transactions in which a charge is reversed and the amounts paid are returned to the buyer. This means the customer will receive the payment amounts back.
There are two ways to process a refund using the endpoint /v1/orders/{order_id}/refundPOST:
- Total: when the total amount of the sale is returned to the buyer. In this case, the amount to be refunded should not be specified in the
bodyof the request, which can be omitted or sent empty. - Partial: when only part of the amount paid is returned to the buyer. In this case, the amount to be refunded should be specified in the
bodyof the request along with the transaction ID.
Before processing a refund, it is important to consider the factors below.
- Refund timeframe: it is possible to refund a payment within 180 days from its approval date.
- Payment method: for credit card payments, the amount will be refunded directly on the statement. For other payment methods, the amount will be refunded to the payer's account.
- Account balance: you must have sufficient balance available in your account to process the refund; otherwise, the transaction will not be completed.
- Multiple partial refunds: it is possible to issue more than one partial refund on the same order, as long as the cumulative amount does not exceed the total amount paid.
To process full or partial refunds for a payment and to check the refunds made in your store, visit our API ReferenceAPI for more information about the endpoint Refund an orderPOST.