list_payment_methods
List the customer's stored cards as the assistant may see them: id, type, brand, last4, expiry (MM/YY or null), is_default and is_expired — never a card number or any token. Use it to tell the customer which card complete_checkout(mode "pay") would charge, or to answer a paymethod_required message by repeating complete_checkout with paymethod_id. An expired card is listed but cannot be charged. error="pay_not_permitted" means this connection may prepare orders but not pay them: complete the checkout with mode "link" instead. Requires the stored-card payment permission the customer granted.
Invoked over the MCP transport with a tools/call request naming this tool.
Authorization #
Requires a valid OAuth 2.1 bearer access_token whose grant includes the orders:pay scope — Place and pay orders with your stored card, if AI ordering is enabled in your client area. The broker resolves the caller from the token and returns only records the account owns.
Parameters #
This tool takes no parameters.
Response #
200 · application/json
Errors #
| Result | When |
|---|---|
| { "error": "backend_unavailable" } | See the tool description for when this result is returned. |
| { "error": "not_found" } | The requested item does not exist, or it belongs to another account. Cross-account IDs are indistinguishable from missing ones by design. |
| { "error": "pay_not_permitted" } | The connection may prepare orders but not pay with the stored card (the pay permission was not granted, or the credential lacks it). Complete with mode "link" and hand over continue_url. |
| { "error": "insufficient_scope" } | The connection does not include the ordering permission; the customer can reconnect and grant it. |
| { "error": "internal_error" } | See the tool description for when this result is returned. |