Simulate sandbox charge event
sandbox_triggerSimulate a test payment state transition on a sandbox charge and fire its matching webhook without moving real funds. Supports confirmed, partially paid, expired, underpaid, settled and overpaid events.
Instructions
Push a test charge into a payment state (confirmed, partially paid, overpaid, expired, underpaid, settled, settlement failed) without moving funds, and fire the matching webhook. Test environment only.
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": {
"event": "<event>",
"chargeId": "<chargeId>"
},
"name": "sandbox_trigger"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| event | Yes | Every charge event that represents a payment-progress state transition a sandbox charge can be pushed into — everything except `charge.created` (a charge already exists by the time you have an id to trigger against) and the two escrow-terminal events, which are reached by actually calling `POST /v1/charges/{id}/release` or `POST /v1/charges/{id}/refund` on a test-environment escrow charge (a real Safe transaction on that network's testnet), not this generic trigger. | |
| amount | No | Used with `charge.partially_paid` (amount to simulate as received so far — must be less than the charge amount, defaults to half of it if omitted) and with `charge.overpaid` (amount received — must be greater than the charge amount, defaults to 1.5x it if omitted). Ignored for every other event. | |
| chargeId | Yes | A Klappay charge id (`ch_` followed by letters and digits). |