Request payment
payment_collectCreates the payment request for the invoice (QR bill, TWINT, card). The flow reaches PAYMENT only on the signed event of the payment provider. Needs state INVOICE. Never: Mark anything paid or pay out without a settled status. Platform fee CHF 0.10 per accepted call: quote first, then send quote_id, mandate_token and idempotency_key.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"mandate_token": "<mandate_token>",
"flow_id": "<flow_id>"
},
"name": "payment_collect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| method | No | How the customer pays: qr_bill (Swiss QR bill), twint or card. | |
| flow_id | Yes | The flow (job) id, which is also its chain id. | |
| quote_id | No | A valid quote for this capability (quote). | |
| mandate_token | Yes | The mandate token from mandate.create. | |
| idempotency_key | No | Required on every mutate and money call; a retry with the same key returns the same result and is not charged again. |