1. Docs
2. /
3. Tool reference
4. /
5. Commerce
6. /
7. refundPayment

Commerce

refundPayment

Refund Payment

Refund ONE settled payment (a paymentId from listPayments) back to the payer's card: in full, or a partial amountMinor.

writedestructiveconsentexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "refund that $70 payment", and it calls refundPayment.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "confirm": true,
    "idempotencyKey": "<idempotencyKey>",
    "paymentId": "<paymentId>"
  },
  "name": "refundPayment"
}

Arguments

• amountMinorintegeroptionalPartial refund in minor units (cents), e.g. 3500 = $35.00. Omit to refund everything still refundable.
• confirmbooleanrequiredMust be true: a refund moves money out and cannot be undone. Pass only after the user explicitly agrees to this refund.
• idempotencyKeystringrequiredYour key for THIS refund request. Reuse it to retry safely; use a new one for a new refund.
• paymentIdstringrequiredThe paymentId to refund (from listPayments).
• reasonstringoptionalWhy the money is going back. Kept on the ledger line.

Returns

Idempotent per idempotencyKey: reuse the SAME key when retrying one refund (the retry returns the refund already made), and a NEW key for a genuinely new refund.

Declared limits

• amountMinor: greater than 0
• amountMinor: maximum 9007199254740991
• idempotencyKey: minimum length 1
• idempotencyKey: maximum length 200
• reason: maximum length 500

Ask for it

The Cloud routes these requests to this verb.

• refund that $70 payment
• give Heidi her money back
• refund half of the booking

Pair it with

The verbs that finish the job.

• listPayments

Questions

• What does refundPayment do?

  Refund ONE settled payment (a paymentId from listPayments) back to the payer's card: in full, or a partial amountMinor. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use refundPayment from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "refund that $70 payment", and it calls refundPayment.

• Is refundPayment safe to let an AI call?

  refundPayment widens who can see or receive something, so the owner approves every call explicitly. An AI cannot approve it for itself. It reaches a system outside The Cloud on your behalf.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.