Re-check charge on-chain
charges_checkTriggers an immediate on-chain re-check of a charge's payment instead of waiting for the background pass, optionally verifying a specific transaction hash on a given network.
Instructions
Ask the API to re-check a charge's payment on-chain now instead of waiting for the background pass. Optionally pass txHash together with network to verify one specific transaction. Never credits anything that is not really on-chain.
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": {
"id": "<id>"
},
"name": "charges_check"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | A Klappay charge id (`ch_` followed by letters and digits). | |
| txHash | No | The on-chain transaction hash to verify directly, if you already have it — e.g. right after a swap-to-pay or wallet-connect transaction is sent. Costs a single RPC call instead of scanning a block range, so the check resolves faster and cheaper. Omit to fall back to scanning recent transfers to this charge's address, the same lookup the background reconciliation pass runs. Never trusted at face value — whatever this transaction actually contains on-chain is what gets credited, regardless of any amount/token implied elsewhere. | |
| network | No | Which network `txHash` is on — required together with `txHash`, since a transaction hash alone doesn't identify a chain. Must be one of the networks this charge actually accepts payment on, or `422 payment_pair_not_accepted`. |