Payment readiness
xrpl_payment_readinessPre-payment check: can this payment from source to destination succeed now? When to use: Right before sending a payment: to catch a missing or unfunded destination, a required destination tag, deposit authorization, missing or frozen trust lines, insufficient balance and issuer freezes, in one call. Prefer another tool: To find a multi-hop route or the source amount needed for a cross-currency payment (use the paths endpoint), or to list balances (use /v1/xrpl/account/{address}/summary). Example: xrpl_payment_readiness {"source":"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh","destination":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B"}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asset | No | XRP (default) or CODE.issuer (3-character or 40-hex code, classic issuer) | |
| amount | No | Positive decimal amount of asset; omit to skip amount-dependent checks | |
| source | Yes | Sending account: valid classic XRPL address (r..., checksum verified) | |
| destination | Yes | Receiving account: valid classic XRPL address, different from source | |
| destination_tag | No | Destination tag you will send: an integer from 0 to 4294967295 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | Yes | ||
| asset | Yes | `XRP` or `CODE.issuer` | |
| amount | Yes | Amount checked; null when omitted (amount checks skipped) | |
| source | Yes | ||
| reasons | Yes | Blocking reason codes | |
| verdict | Yes | `not_ready` on any blocking reason; else `unknown` on any failed sub-check | |
| warnings | Yes | Non-blocking warnings | |
| destination | Yes | ||
| checks_failed | Yes | Sub-checks that could not run | |
| spendable_xrp | Yes | Source XRP above its live reserve and the standard fee; null when not computable | |
| destination_tag | Yes | ||
| transfer_fee_pct | Yes | Issuer transfer fee in percent, when it applies |