> ## 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.

# test_charge

> Sandbox only: simulate a merchant charging a test card, driving the exact settlement a real charge does — authorization, clearing, the one-time-use auto-close,…

Connect to `https://mcp.agentcard.sh/mcp` with your **organization credential** (`client_id` + `client_secret`, or the org access token).

**Behavior:** destructive.

## What it does

Sandbox only: simulate a merchant charging a test card, driving the exact settlement a real charge does — authorization, clearing, the one-time-use auto-close, and the same webhooks (transaction.authorized, transaction.cleared, card.closed). Use it to prove an integration end to end without real money.

## Inputs

| Field                  | Type   | Description                                                         |
| ---------------------- | ------ | ------------------------------------------------------------------- |
| `card_id` *(required)* | string | The sandbox card id                                                 |
| `amount_cents`         | number | Charge amount in cents (default: \$6.75 capped at the card balance) |
| `merchant`             | string | Merchant descriptor (default "COFFEE SHOP #42 SAN FRANCISCO")       |

## Returns

| Field                  | Type   | Description                                                |
| ---------------------- | ------ | ---------------------------------------------------------- |
| `message` *(required)* | string | Human-readable outcome.                                    |
| `paymentId`            | string | The settled payment id.                                    |
| `cardStatus`           | string | Post-charge card status (CLOSED — cards are one-time-use). |
| `events`               | array  | Webhook events this charge emitted.                        |

## Example call

```json theme={null}
{
  "tool": "test_charge",
  "arguments": {
    "card_id": "\u2026"
  }
}
```