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

Commerce

createPaymentLink

Create Payment Link

Access: the shop owner, or an editor of the shop's Space.

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "create a payment link", and it calls createPaymentLink.

Example call

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

{
  "arguments": {
    "customer": {},
    "title": "<title>"
  },
  "name": "createPaymentLink"
}

Arguments

• currencystringoptionalNo description is declared in the tool schema.
• customerobjectrequiredNo description is declared in the tool schema.
• depositobjectoptionalNo description is declared in the tool schema.
• dueDatestringoptionalNo description is declared in the tool schema.
• entryIdstringoptionalNo description is declared in the tool schema.
• lineItemsobject[]optionalHand-typed lines in the one line-item shape every money page uses: name, detail (one short line), qty and amountCents (one unit, required here). Each becomes a manual line; they add to lines.
• linesobject[]optionalNo description is declared in the tool schema.
• locationIdstringoptionalThe pickup counter for a shop that hands goods over. Omit it for a service business: with spaceId alone the link bills through that Space's own bound payment account and implies no pickup.
• memostringoptionalNo description is declared in the tool schema.
• orderIdstringoptionalNo description is declared in the tool schema.
• paymentMethodsstring[]optionalHow the customer may pay. Absent uses the shop cart setting. An explicit list belongs to this link and is honored exactly when the account supports it.
• paymentTermsobjectoptionalThe cadence: {kind:"one_time"} (the default) or {kind:"deposit_then_balance", depositAmountMinor or depositBasisPoints}. Use instead of deposit. A subscription or a run of payments is createOffer or createRecurringPaymentLink.
• spaceIdstringoptionalThe Space the link is raised on and bills through. Required when locationId is omitted.
• titlestringrequiredNo description is declared in the tool schema.

Returns

When a person asks for an invoice, a bill, a mock-up, a quote or a proposal, call this and return payUrl and previewUrl; never answer with a typed table.

Declared limits

• currency: minimum length 3
• currency: maximum length 3
• lineItems: maximum items 20
• lines: maximum items 50
• title: minimum length 1

Ask for it

The Cloud routes these requests to this verb.

• create a payment link
• request a deposit
• make a balance link
• send a link for this cake

Pair it with

The verbs that finish the job.

• listProducts
• getProductConfiguration
• sendPaymentLink
• attachPaymentLinkToEntry

Questions

• What does createPaymentLink do?

  Access: the shop owner, or an editor of the shop's Space. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use createPaymentLink 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 "create a payment link", and it calls createPaymentLink.

• Is createPaymentLink safe to let an AI call?

  createPaymentLink changes your workspace. What an AI creates is Private until you share it.

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.