PrimCard Partner API

Issue and manage USD virtual cards from your own system over a simple REST API — your users never leave your product, and card money never touches yours.

How it works

PrimCard runs on a pre-funded model: you hold a balance with us (funded by USDT deposit or invoice), and every card you create or top up draws from it. Fees are charged on top of what you ask for — request a $100 card and the card receives exactly $100.00, while your balance is debited $100 plus the fees your account is on. POST /quotes tells you the exact cost before you commit.

  • Cards — create, top up, freeze/unfreeze, block, list transactions.
  • BIN choice — issue on any card BIN enabled for your account (GET /products).
  • Funding — USDT (TRC-20) deposit addresses with automatic crediting.
  • Webhooks — signed push notifications for issuance, top-ups, card spend, and deposits.
  • Test mode — every endpoint works with sk_test_ keys and pretend money before you go live.

Base URL

https://www.primcard.io/api/partner/v1

All amounts everywhere are integer minor units (USD cents): 10000 means $100.00. No floats, ever.

Get access

Partner accounts are created by the PrimCard team — contact support@primcard.io to get onboarded. You'll receive a test key immediately and a live key once your account is funded.

New here? Start with the Quickstart — sandbox key to first card in about five minutes. The full contract is in the API reference and the machine-readable OpenAPI spec.