get_payment_link
Create or refresh a secure payment link for an existing booking.
This call creates externally observable payment-provider and booking state,
then returns payment_url, the operator's own payment page covering every
reserved leg of the trip, together with included_bookings and the total.
Where the payment card is displayed, it shows the legs and total, opens
payment_url and marks the trip paid once payment settles; without the card,
payment_url is the traveller's only way to pay. Sóley never processes
payments directly — the operator is the merchant of record.
If the consolidated link would span bookings started in different sessions
on the same phone, the response is 'requires_confirmation' instead of a URL:
relay the included bookings + total to the traveller, then re-call with
confirm=true once approved.
The response transaction_mode is demo, sandbox, or live. If demo_notice is
present, relay it exactly; live responses intentionally omit demo_notice and
use the normal payment copy.
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": {
"booking_reference": "<booking_reference>",
"operator_id": "<operator_id>"
},
"name": "get_payment_link"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | Leave false on the first call. If the response comes back with 'requires_confirmation': true, the link would combine bookings from more than one shopping session on this phone — show the traveller the 'included_bookings' and total, and only after they confirm those all belong to this trip, call get_payment_link again with confirm=true. If some are not wanted, cancel_booking them first. | |
| operator_id | Yes | Unique operator slug, e.g. 'fosshotel-reykjavik' or 'arctic-adventures'. Obtain from search_operators. Do not guess — always look up first. | |
| booking_reference | Yes | Booking reference code returned by create_booking. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||