Skip to main content
POST
/
business
/
card
/
issue
Issue a virtual card
curl --request POST \
  --url https://api-staging.usenumero.com/numeroaccount/api/v1/business/card/issue \
  --header 'Content-Type: application/json' \
  --header 'X-Numero-Api-Key: <api-key>' \
  --data '
{
  "productCode": "USD_VIRTUAL",
  "firstName": "<string>",
  "lastName": "<string>",
  "capability": "APPLE_PAY",
  "initialBalance": 5,
  "brand": "visa",
  "label": "Ads spend",
  "email": "<string>",
  "phone": "<string>",
  "dateOfBirth": "2023-12-25",
  "address1": "<string>",
  "city": "<string>",
  "state": "<string>",
  "zipcode": "<string>",
  "country": "NG",
  "idType": "PASSPORT",
  "idNumber": "<string>",
  "bvn": "<string>",
  "idDocumentFrontUrl": "<string>"
}
'
{
  "data": {
    "cardReference": "NCRD24AD18BEBD474A",
    "customerId": "NCUS9953596C2B7F45",
    "label": "<string>",
    "brand": "Visa",
    "firstSix": "428852",
    "lastFour": "6353",
    "expiryMonth": "06",
    "expiryYear": "2029",
    "currency": "USD",
    "balance": 5,
    "isPhysical": true,
    "dailyLimit": 123,
    "perTransactionLimit": 123,
    "issuedAt": "2023-11-07T05:31:56Z",
    "capabilities": [
      "USD",
      "APPLE_PAY",
      "GOOGLE_PAY"
    ]
  },
  "error": {
    "message": "<string>",
    "param": "<string>"
  },
  "meta": {
    "request_id": "<string>",
    "pagination": {
      "page": 123,
      "page_size": 123,
      "total": 123,
      "has_more": true
    }
  }
}

Authorizations

​
X-Numero-Api-Key
string
header
required

Your business API key (live_key_...). Issued on approval; managed in Dashboard → Settings → Developer.

Body

application/json
​
productCode
string
required

Card product code (drives currency + card type). Discover available products via GET /business/card/products.

Example:

"USD_VIRTUAL"

​
firstName
string
required
​
lastName
string
required
​
capability
enum<string> | null

Card type. Omit (or USD) for a plain USD virtual card; APPLE_PAY or GOOGLE_PAY to issue a wallet-enabled USD card the cardholder can add to Apple/Google Wallet. Numero routes to an issuer that supports it.

Available options:
USD,
APPLE_PAY,
GOOGLE_PAY,
null
Example:

"APPLE_PAY"

​
initialBalance
number

USD loaded onto the card at issue (debited from your USD card wallet).

Example:

5

​
brand
string | null
Example:

"visa"

​
label
string | null

Friendly card name.

Example:

"Ads spend"

​
email
string | null
​
phone
string | null
​
dateOfBirth
string<date> | null
​
address1
string | null
​
city
string | null
​
state
string | null
​
zipcode
string | null
​
country
string | null
Example:

"NG"

​
idType
string | null
Example:

"PASSPORT"

​
idNumber
string | null
​
bvn
string | null
​
idDocumentFrontUrl
string | null

ID-document image URL — required by some issuers.

Response

The issued card (masked only)

Canonical response envelope for the public surface. data on success, error on failure.

​
data
object
required

A card as exposed to you — masked only.

​
error
object
required
​
meta
object
required