Check Payment - Naïve

POST

/

v1

/

cards

/

:id

/

check-payment

curl -X POST https://api.usenaive.ai/v1/cards/card-uuid-1/check-payment \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "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"
}

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

curl -X POST https://api.usenaive.ai/v1/cards/card-uuid-1/check-payment \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "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"
}

CLI

naive cards check-payment <id>

MCP

Tool: naive_cards_check_payment

{
  "card_id": "card-uuid-1"
}

curl -X POST https://api.usenaive.ai/v1/cards/card-uuid-1/check-payment \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "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"
}