Skip to main content
Issue a USD virtual card. Pass the cardholder’s KYC inline (the cardholder is created or reused automatically), or use the Cardholders flow to issue to an existing cardholder. initialBalance is debited from your USD card wallet (fund-first). Choose the card type with capability — omit (or USD) for a plain card, APPLE_PAY/GOOGLE_PAY for a wallet-enabled card.
Card endpoints use the same base URL and API key as the rest of the API and are not signature-gated.

​
Endpoint

POST /api/v1/business/card/issue
Signature required: No

​
Headers

HeaderRequiredDescription
X-Numero-Api-KeyYesYour API key

​
Request body

FieldTypeRequiredDescription
productCodestringYesCard product to issue from (see List Card Products)
capabilitystringNoUSD (default) · APPLE_PAY · GOOGLE_PAY — selects the card type
initialBalancenumberNoUSD loaded onto the card at issue (debited from your USD card wallet)
firstNamestringYesCardholder first name
lastNamestringYesCardholder last name
emailstringNoCardholder email
phonestringNoCardholder phone
dateOfBirthstringNoYYYY-MM-DD
address1stringNoStreet address
citystringNoCity
statestringNoState
zipcodestringNoPostal code
countrystringNoISO country code, e.g. NG
idTypestringNoe.g. BVN, PASSPORT
idNumberstringNoID number
bvnstringNoBank Verification Number (required by some issuers)
labelstringNoFriendly card name

​
Request example

curl -X POST "https://api-dev.usenumero.com/numeroaccount/api/v1/business/card/issue" \
  -H "X-Numero-Api-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "productCode": "USD_APPLE_PAY",
    "capability": "APPLE_PAY",
    "initialBalance": 25,
    "firstName": "Ada",
    "lastName": "Obi",
    "email": "[email protected]",
    "country": "NG",
    "bvn": "22222222222"
  }'

​
Response

Returns the issued card (masked only). 
{
  "status": true,
  "message": "Successful",
  "code": "200",
  "version": "v1",
  "reference": "N20260616120000",
  "data": {
    "cardReference": "NCRD24AD18BEBD474A",
    "customerId": "NCUS9953596C2B7F45",
    "label": "Ads spend",
    "brand": "Visa",
    "firstSix": "428852",
    "lastFour": "6353",
    "expiryMonth": "06",
    "expiryYear": "2029",
    "currency": "USD",
    "balance": 25.00,
    "status": "Active",
    "isPhysical": false,
    "dailyLimit": 5000,
    "perTransactionLimit": 1000,
    "issuedAt": "2026-06-16T12:00:00Z",
    "capabilities": ["USD", "APPLE_PAY", "GOOGLE_PAY"]
  },
  "error": null
}