Verify Payment & Issue Access Token
verify_paymentSubmit tx_hash after paying an invoice. Supports XRPL, Xahau, Base (0x… hash), and Solana. Returns a signed JWT access_token (1-hour TTL). For a Xahau invoice with fee_required=true, also submit fee_tx_hash (the 0.01 XAH facilitator-fee payment) — settlement requires both payments. Free.
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": {
"invoice_id": "<invoice_id>",
"recovery_secret": "<recovery_secret>",
"tx_hash": "<tx_hash>",
"agent_wallet": "<agent_wallet>"
},
"name": "verify_payment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tx_hash | Yes | XRPL/Xahau: 64-char hex; Base: 0x-prefixed hex; Solana: base58 signature | |
| invoice_id | Yes | Invoice ID returned by get_invoice | |
| fee_tx_hash | No | Xahau only, when the invoice has fee_required=true: tx hash of the 0.01 XAH facilitator-fee payment to fee_pay_to carrying fee_memo_hex | |
| agent_domain | No | Optional domain of the paying agent, recorded on the compliance receipt | |
| agent_wallet | Yes | The paying agent's wallet address on the invoice's rail (XRPL classic address, Base 0x address, or Solana address) | |
| recovery_secret | Yes | Private high-entropy secret returned only with the original invoice; required to recover a previously settled token after lost response/restart |