Home / Servers / Stripe API / post_terminal_readers_reader_refund_payment

Refund a Charge or a PaymentIntent in-person

An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.

Refund a Charge or a PaymentIntent in-person Initiates an in-person refund on a Reader. See Refund an Interac Payment for more details. [POST /v1/terminal/readers/{reader}/refund_payment]

Name on the gateway: stripe_api__post_terminal_readers_reader_refund_payment · may change things.

Parameters

NameTypeDescription
reader requiredstringreader parameter
amountintegerA positive integer in __cents__ representing how much of this charge to refund.
chargestringID of the Charge to refund.
expandarraySpecifies which fields in the response should be expanded.
metadataobjectSet of key-value pairs that you can attach to an object. This can be useful…
payment_intentstringID of the PaymentIntent to refund.
refund_application_feebooleanBoolean indicating whether the application fee should be refunded when…
refund_payment_configobjectConfiguration overrides for this refund, such as customer cancellation settings.
reverse_transferbooleanBoolean indicating whether the transfer should be reversed when refunding this…

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "stripe_api__post_terminal_readers_reader_refund_payment",
  "arguments": {
    "reader": "…"
  }
}

Or connect the Stripe API server directly, which lists 606 tools including this one:

Run in your terminal
claude mcp add --transport http hj-stripe-api https://mcp.hjlabs.in/mcp/stripe-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the refund a charge or a paymentintent in-person tool with reader set to ….

More from Stripe API