Skip to main content

4pay.cc API Documentation

4pay.cc is a B2B platform for issuing and managing virtual and physical payment cards. Via a single REST API you can:

  • Issue virtual cards instantly for your users or internal purposes
  • Manage wallets — top up via crypto (USDT/USDC on TRON), transfer funds between wallets
  • Control card lifecycle — fund, freeze, resume, and terminate cards
  • Track all transactions — card purchases, top-ups, fees, and wallet operations

Base URL​

All API requests are made to:

https://api.4pay.cc

API Version​

Current version: v2

All endpoints are prefixed with /api/v2/.

Quick Overview​

ResourceDescription
WalletsFunding accounts linked to card providers
CardsVirtual and physical payment cards (instruments)
HoldersCard holders — the people associated with cards
DepositsCrypto top-ups (USDT / USDC on TRON network)
OperationsTransaction history for cards and wallets

Typical Integration Flow​

1. Create a Holder        →  POST /api/v2/organizations/{org_id}/holders
2. Get BIN options        →  POST /api/v2/organizations/{org_id}/bin-options  ← choose BIN/category
3. Create a Wallet        →  POST /api/v2/organizations/{org_id}/wallets
4. Deposit funds          →  POST /api/v2/organizations/{org_id}/deposits
5. Issue a Card           →  POST /api/v2/organizations/{org_id}/wallets/{wallet_id}/instruments
6. Fund the Card          →  PATCH .../instruments/{instrument_id}/fund
7. Get card credentials   →  GET  .../instruments/{instrument_id}/credentials

Key Concepts​

Organization (org_id)​

Your organization identifier. Every API call is scoped to your organization. You receive org_id when your account is created in the dashboard.

Async Operations​

Many operations (card issuance, wallet activation, fund transfers) are asynchronous — the API accepts the request and returns immediately with a 201 Created or 204 No Content. Poll the corresponding GET endpoint to verify the result.

Pagination​

List endpoints support page and quantity query parameters. Responses include a pagination object:

{
  "data": [...],
  "pagination": {
    "currentPage": 1,
    "pages": 5,
    "quantity": 25,
    "totalQuantity": 112
  }
}

Support​