Refund Card - Naïve

POST

/

v1

/

cards

/

:id

/

refund

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

{
  "card": {
    "id": "card-uuid-1",
    "name": "Marketing Card",
    "provider": "managed_virtual",
    "status": "refunded",
    "spending_limit_cents": 5000,
    "balance_cents": 0,
    "created_at": "2026-03-01T10:00:00Z"
  },
  "refund": {
    "id": "re_1abc123",
    "status": "succeeded"
  }
}

Initiates a refund for a card in issuing_failed or payment_failed status. The refund is processed back to the original payment method.

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

{
  "card": {
    "id": "card-uuid-1",
    "name": "Marketing Card",
    "provider": "managed_virtual",
    "status": "refunded",
    "spending_limit_cents": 5000,
    "balance_cents": 0,
    "created_at": "2026-03-01T10:00:00Z"
  },
  "refund": {
    "id": "re_1abc123",
    "status": "succeeded"
  }
}

Error Response

If the card is not in a refundable status:

{
  "error": "Card must be in issuing_failed or payment_failed status to refund"
}

CLI

naive cards refund <id>

MCP

Tool: naive_cards_refund

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

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

{
  "card": {
    "id": "card-uuid-1",
    "name": "Marketing Card",
    "provider": "managed_virtual",
    "status": "refunded",
    "spending_limit_cents": 5000,
    "balance_cents": 0,
    "created_at": "2026-03-01T10:00:00Z"
  },
  "refund": {
    "id": "re_1abc123",
    "status": "succeeded"
  }
}