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

# Check Payment

> Check the checkout payment status for a card

Checks the current payment/checkout status of a card. Use this after creating a card to verify whether payment has completed.

### Possible Statuses

| Status            | Description                                |
| ----------------- | ------------------------------------------ |
| `active`          | Payment successful, card is ready to use   |
| `pending_payment` | Checkout session created, awaiting payment |
| `payment_failed`  | Payment was declined or expired            |
| `issuing_failed`  | Payment succeeded but card issuance failed |

<RequestExample>
  ```bash theme={"theme":"css-variables"}
  curl -X POST https://api.usenaive.ai/v1/cards/card-uuid-1/check-payment \
    -H "Authorization: Bearer nv_sk_live_..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":"css-variables"}
  {
    "card": {
      "id": "card-uuid-1",
      "name": "Marketing Card",
      "provider": "managed_virtual",
      "status": "active",
      "spending_limit_cents": 5000,
      "balance_cents": 5000,
      "created_at": "2026-03-01T10:00:00Z"
    },
    "status": "active"
  }
  ```
</ResponseExample>

## CLI

```bash theme={"theme":"css-variables"}
naive cards check-payment <id>
```

## MCP

Tool: `naive_cards_check_payment`

```json theme={"theme":"css-variables"}
{
  "card_id": "card-uuid-1"
}
```