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

Commerce

refundCounterPayment

Refund Counter Payment

Refund ONE counter sale (an orderId from readCounterTakings with a session): in full, or a partial amountMinor.

writedestructiveconsentexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "refund the latte order at the counter", and it calls refundCounterPayment.

Example call

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

{
  "arguments": {
    "confirm": true,
    "orderId": "<orderId>",
    "reason": "<reason>"
  },
  "name": "refundCounterPayment"
}

Arguments

• amountMinorintegeroptionalPartial refund in minor units (600 = $6.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.
• orderIdstringrequiredThe counter order to refund (from readCounterTakings).
• reasonstringrequiredWhy the money is going back. Kept on the order's history.
• spacestringoptionalSpace id or slug (see listPageSpaces) for a Space-owned shop. Omit for your personal shop.
• spaceIdstringoptionalSame as `space`: the Space id (see listPageSpaces) of a Space-owned shop. Pass either one. Omit both for your personal shop.

Returns

The registry does not declare a return shape.

Declared limits

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

Ask for it

The Cloud routes these requests to this verb.

• refund the latte order at the counter
• give her $6 back for the croissant
• refund order 1042, it was burnt

Pair it with

The verbs that finish the job.

• readCounterTakings
• refundPayment

Questions

• What does refundCounterPayment do?

  Refund ONE counter sale (an orderId from readCounterTakings with a session): in full, or a partial amountMinor. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use refundCounterPayment 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 the latte order at the counter", and it calls refundCounterPayment.

• Is refundCounterPayment safe to let an AI call?

  refundCounterPayment 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.