Request payment
Send a customer a payment request with a link to pay by card.
MCP tool podium_write → request_payment
write Confirm
Sends a payment request to a phone number or an email address, as Request payment does on the Payments page. The customer gets a payment link by text, or by email when you pass an email address. invoice_number and description appear on the request. The request reaches a customer and asks for money. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| location string | string | Location ID from list_locations. Needed when your account has more than one location. |
| to string required | string | Customer phone number or email address. |
| amount number required | number | Amount to request, as you would type it in the request form. |
| description string | string | What the payment is for. |
| invoice_number string | string | Your invoice number, shown on the request. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "podium_write",
"arguments": {
"operation": "request_payment",
"arguments": {
"to": "to",
"amount": 1
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"payment_request_id": "pay_3c19",
"invoice_number": "INV-1042",
"amount": 480,
"status": "pending",
"sent_via": "text"
},
"isError": false
}