Book a demo

List Refunds

stripe.list_refunds
ActionBusiness appsconnection required

Calls the Stripe API with the connection's secret key.

List Stripe refunds, newest first, optionally for one charge or intent.

Ask about StripeAll Stripe nodesProvider API docs ↗

Connection

Required
Yes — the node will not save without one
Auth type
API key
Providers
Stripe
Secret shape
the Stripe secret key (sk_...)
Resolved by
config.connection_id, else node.connection_id

Configuration

7 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
charge
Return only refunds of this charge (ch_...).
stringNo———
payment_intent
Return only refunds of this PaymentIntent (pi_...).
stringNo———
limit
How many objects to return, 1-100. Stripe defaults to 10.
numberNo101–100—
starting_after
Cursor: return the page after this object id, for walking forward.
stringNo———
ending_before
Cursor: return the page before this object id, for walking backward.
stringNo———
created_after
Only objects created at or after this Unix timestamp, in seconds.
numberNo—≥ 0—
created_before
Only objects created at or before this Unix timestamp, in seconds.
numberNo—≥ 0—

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "limit": 10
}

Output

One shape.

result

FieldTypeExample
refunds[].id
The refund id (re_...).
string—
refunds[].amount
Amount refunded, in the currency's minor unit.
number—
refunds[].currency
Three-letter lowercase ISO currency code.
string—
refunds[].charge
The charge that was refunded, or null.
string—
refunds[].payment_intent
The PaymentIntent that was refunded, or null.
string—
refunds[].reason
The recorded reason, or null when none was given.
string—
refunds[].status
One of pending, requires_action, succeeded, failed or canceled.
string—
refunds[].created
Creation time, as a Unix timestamp in seconds.
number—
refunds[].metadata
The key/value pairs stored on the refund.
object—
count
How many objects this page returned.
number—
has_more
True when Stripe has a further page to fetch.
boolean—
{
  "count": 0,
  "has_more": false,
  "refunds": [
    {
      "amount": 0,
      "charge": "",
      "created": 0,
      "currency": "",
      "id": "",
      "metadata": {},
      "payment_intent": "",
      "reason": "",
      "status": ""
    }
  ]
}

Related Stripe nodes

Templates that use Stripe

Solutions with Stripe

See List Refunds run in a workflow.

In a technical demo we add the Stripe connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demoTalk to sales