MercadoPago Refunds and Cancellations for Custom Checkout

Refunds

MercadoPago provides an API to make refunds. There are two types of refund: Full Refund (the payment is completely refunded), or Partial Refund (part of the payment is refunded).

Full Refund

To make a full refund, you will need the Payment's Id.

Event 'FullRefund'
    MercadoPago.PaymentCustomCheckout.FullRefund(&PaymentId,&RefundSDT,&Message,&ErrorCode)
    &ResponsePaymentInfo = &RefundSDT.ToXml()
    if &ErrorCode = 0
        //Success
    else
        Msg(&Message.Description)
    endif
Endevent

&RefundSDT is RefundSDT data type, which is used to receive information about the refund.
&Message contains a description in case an error occurs.

Partial Refund

To make a partial refund, you will need the Payment's Id and the amount that is going to be refunded.
Note: That amount cannot be greater than the payment's total cost.

Event 'PartialRefund'
    MercadoPago.PaymentCustomCheckout.PartialRefund(&PaymentId,&refundAmount,&RefundSDT,&Message,&ErrorCode)
    &ResponsePaymentInfo = &RefundSDT.ToXml()
    if &ErrorCode = 0
        //Success
    else
        Msg(&Message.Description)
    endif
EndEvent

&RefundSDT is RefundSDT data type, which is used to receive information about the refund.
&Message contains a description in case an error occurs.
&refundAmount is the amount to be refunded.

Restrictions

• You must have enough available money in your account so you can refund the payment amount successfully. Otherwise, you'll get a 400 Bad Request error.
• You can refund a payment within 90 days after it was accredited.
• You can only refund payments made with cards.
• You can only refund approved payments.
• You can perform up to 20 partial refunds in one payment.
• By now, it is not possible to perform partial refunds of payments made to MercadoLibre articles (marketplace=MELI).
• By now, it is not possible to perform partial refunds of payments made with Brazilian MercadoLibre card (payment_method_id=melicard).
• By now, it is not possible to perform partial refunds of recurring payments in Argentina (operation_type=recurring_payment).

Behavior

• The payment status will be approved:partially_refunded until it is refunded. Just then the status will change to refunded
• The refund of payments made with credit card will be reimbursed in the card statement.
• All fees and taxes will be refunded partially in a proportional way.

Cancellation

To cancel a payment, you will need the Payment's Id.

Event 'CancelPayment'
    MercadoPago.PaymentCustomCheckout.CancelPayment(&PaymentId,&PaymentInfoSDT,&Message,&ErrorCode)
    &ResponsePaymentInfo = &PaymentInfoSDT.ToXml()
    if &ErrorCode = 0
        //Success
    else
        Msg(&Message.Description)
    endif
Endevent

&PaymentInfoSDT is used to receive the payment's new status, where you can confirm the cancellation was made successfully.

Remarks

• Only pending or in_process payments can be canceled.
• Cancelled coupon payments, deposits, and transfers will be deposited in the buyer’s MercadoPago account.