create_refund
Issue a refund for a PaymentIntent. Specify the payment ID and optionally set the refund amount and reason.
Instructions
Creates a refund for a specific PaymentIntent. Can refund the full amount or a partial amount. This is a destructive financial operation.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"payment_intent_id": "<payment_intent_id>"
},
"name": "create_refund"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| payment_intent_id | Yes | The ID of the PaymentIntent to refund (e.g., 'pi_123'). | |
| amount | No | Amount to refund in the smallest currency unit (e.g., cents). If omitted, refunds the full amount. | |
| reason | No | Reason for the refund. One of: 'duplicate', 'fraudulent', or 'requested_by_customer'. |