Stripe - Create Refund

Description

This module allows you to create refunds for previously completed payments. It can be a full or partial refund, with the option to specify the reason.

Configuration

Required Credentials

• Secret Key: Stripe secret key

Parameters

Parameter	Type	Required	Description
credentials_id	credential	Yes	Stripe credentials
payment_intent_id	string	Yes*	Payment Intent ID (pi_xxx)
charge_id	string	Yes*	Charge ID (ch_xxx) - alternative
amount	number	No	Amount to refund (empty = full)
reason	select	No	Refund reason
metadata	string	No	Additional metadata (JSON)

*Either payment_intent_id or charge_id is required

Refund Reasons

• duplicate: Duplicate payment
• fraudulent: Fraudulent payment
• requested_by_customer: Requested by the customer

Output

{
  "success": true,
  "refund": {...},
  "refund_id": "re_3MtwBwLkdIwHu7ix28a3tqPa",
  "status": "succeeded",
  "amount": 99.99,
  "currency": "usd",
  "message": "Reembolso re_3MtwBw... creado (succeeded)"
}

Refund Statuses

• pending: Pending
• succeeded: Successful
• failed: Failed
• canceled: Canceled

Usage Example

Full refund

{
  "payment_intent_id": "pi_3MtwBwLkdIwHu7ix28a3tqPa"
}

Partial refund

{
  "payment_intent_id": "pi_3MtwBwLkdIwHu7ix28a3tqPa",
  "amount": 25.00,
  "reason": "requested_by_customer"
}

Refund with metadata

{
  "charge_id": "ch_3MtwBwLkdIwHu7ix28a3tqPa",
  "reason": "duplicate",
  "metadata": "{\"ticket_id\": \"SUPPORT-123\"}"
}

API Used

• Endpoint: POST /v1/refunds
• Documentation: Stripe Refunds API

Notes

• If no amount is specified, the full amount is refunded
• Partial refunds can be made multiple times
• The amount is automatically converted to cents
• Refunds may take 5-10 days to appear in the customer’s account

Related Nodes

• StripeGetPaymentIntents - Get the Payment Intent to refund
• StripeCreatePaymentIntent - Create payments that can later be refunded
• StripeGetCustomers - Get payment customer data