payware_poi_set_price
Set a pending price on a POI for customer payment, moving the POI to READY until a scan or TTL expiry.
Instructions
[Merchant] Set a pending price on a POI for customer payment.
Authentication: your own JWT (an ISV makes the same call on your behalf). Endpoint: PUT /poi/{poiId}/price Use Case: Set the amount a customer should pay when they scan the POI.
The POI moves to READY and waits for a scan until the TTL expires. The scan creates the transaction and the POI is BUSY until the sale is final.
Only amount, currency and ttlSeconds are accepted. There is no description, callback URL or passback field on a price - the callback URL is set on the POI when it is created, and a POI without one sends no callbacks.
Keep the returned sessionToken until the sale has a final status: pass it to payware_poi_get_status to read that sale's transaction and outcome.
Required: POI ID, amount, currency.
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": {
"poiId": "<poiId>",
"amount": "<amount>",
"currency": "<currency>"
},
"name": "payware_poi_set_price"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| poiId | Yes | The POI identifier (format: pi + 8 alphanumeric chars, e.g., piABC12345) | |
| amount | Yes | Payment amount (e.g., '25.50'), positive and no finer than the currency's smallest unit | |
| currency | Yes | ISO 4217 currency code (e.g., 'EUR', 'USD', 'GBP') | |
| ttlSeconds | No | Seconds until the price expires if nobody scans it (60-600). Defaults to the POI's own ttlSeconds. | |
| useSandbox | No | Use sandbox environment for testing |