> ## 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` | number | Charge amount, an integer in the currency's smallest unit: 675 for \$6.75 (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"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.