Commerce
refundPayment
Refund Payment
Refund ONE settled payment (a paymentId from listPayments) back to the payer's card, in full or as a partial amountMinor.
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": {},
"name": "refundPayment"
}Arguments
amountMinorintegeroptionalPartial refund in minor units (cents), e.g. 3500 = $35.00. Omit to refund everything still refundable. Ignored with approvalId: the approved amount is sent.approvalIdstringoptionalSend a refund an owner or admin approved (from requestRefundApproval). With it, confirm, paymentId and idempotencyKey are not needed.confirmbooleanoptionalMust be true without an approvalId: a refund moves money out and cannot be undone. Pass only after the user explicitly agrees to this refund.idempotencyKeystringoptionalYour key for THIS refund request, required without an approvalId. Reuse it to retry safely; use a new one for a new refund.paymentIdstringoptionalThe paymentId to refund (from listPayments), required without an approvalId.reasonstringoptionalWhy the money is going back. Kept on the ledger line.
Returns
Or pass approvalId instead to send a refund a Space owner or admin already approved in The Cloud (from requestRefundApproval): the approval is the consent, its amount and reason are used, and its…
Declared limits
amountMinor: greater than 0amountMinor: maximum 9007199254740991idempotencyKey: minimum length 1idempotencyKey: maximum length 200reason: maximum length 500
Ask for it
The Cloud routes these requests to this verb.
- refund that $70 payment
- give Sam her money back
- refund half of the booking
- send the approved refund
Pair it with
The verbs that finish the job.
Questions
What does refundPayment do?
Refund ONE settled payment (a paymentId from listPayments) back to the payer's card, in full or as 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.