Mercado Pago - Create Refund

Description

Creates a full or partial refund for a payment in Mercado Pago. Allows returning money to the payer in full or in cumulative partial amounts.

Configuration

Field	Type	Required	Description
credentials_id	credential	Yes	Mercado Pago credentials
payment_id	string	Yes	Payment ID to refund
amount	number	No	Amount to refund (empty = full)

Credentials

This module requires a mercadopago type credential with the following fields:

• Access Token: Mercado Pago access token (obtained from the developer dashboard)

Output

{
  "success": true,
  "refund": {
    "id": 987654321,
    "payment_id": 123456789,
    "amount": 100.00,
    "status": "approved",
    "date_created": "2024-01-15T10:00:00.000-03:00"
  },
  "refund_id": 987654321,
  "payment_id": 123456789,
  "amount": 100.00,
  "message": "Reembolso 987654321 creado por 100"
}

Refund Statuses

• approved: Refund approved
• pending: Refund pending processing
• in_process: In process
• rejected: Rejected

Usage Example

Full refund

{
  "payment_id": "123456789"
}

Partial refund

{
  "payment_id": "123456789",
  "amount": 50.00
}

API Used

• Endpoint: POST /v1/payments/{id}/refunds
• Documentation: Mercado Pago Refunds API

Notes

• Only payments with approved status can be refunded
• Partial refunds are cumulative (you can make several until covering the total)
• The maximum refund amount is the original payment amount
• If amount is not specified, the full amount is refunded
• The crediting time depends on the original payment method

Related Nodes

• MercadopagoGetPayments - Get payments
• MercadopagoCreatePayment - Create payment