> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# pay_checkout

> Auto-fill a checkout page with an Agentcard virtual card and pay

Fills a checkout page with an Agentcard virtual card: it creates or reuses a card, then fills the card number, expiry, CVC, email, and billing address through the Agentcard Pay Chrome extension. Requires Chrome with the extension installed and signed in; if it is missing, run `npx agent-cards extension install` and load it in Chrome.

## Parameters

| Parameter      | Type   | Required | Description                                                                            |
| -------------- | ------ | -------- | -------------------------------------------------------------------------------------- |
| `url`          | string | No       | Navigate to this checkout URL first, then pay. If omitted, uses the active Chrome tab. |
| `amount_cents` | number | No       | Amount in cents. If omitted, auto-detects from the checkout page.                      |
| `tab_id`       | number | No       | Chrome tab ID. If omitted, uses the active tab.                                        |

## Returns

A summary with the card ID, last 4 digits, amount, fill status, and which form fields were filled. If creating the card needs the user's approval, it returns `status: "approval_required"` with an `approvalId` to pass to `approve_request`; call `pay_checkout` again after approval. On failure it returns `status: "error"` with an error message.

## Example

```json theme={null}
{ "name": "pay_checkout", "arguments": { "url": "https://shop.example.com/checkout" } }
```