Skip to main content
POST
/
v1
/
cards
Create card
curl --request POST \
  --url https://api.platnova.com/v1/cards \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "currency": "ngn",
  "brand": "mastercard",
  "amount": 15000,
  "wallet_id": "43a2b75e-5c59-429e-872a-2a54c7b17e37"
}
'
{
  "status": true,
  "data": {
    "customer": {
      "id": "43a2b75e-5c59-429e-872a-2a54c7b17e34",
      "first_name": "John",
      "last_name": "Doe",
      "email": "[email protected]"
    },
    "card_id": "18ee492a-617c-4878-958a-2ee08dc20ff4",
    "card_status": "processing",
    "card_brand": "mastercard",
    "card_currency": "ngn"
  },
  "error": [],
  "message": "operation was successful"
}

​
Overview

Create a USD or NGN virtual card for a customer. This endpoint allows you to issue a new virtual card with a specified currency, brand, and initial funding amount. The card will be linked to the customer’s account and can be used for online and in-store purchases.

Authorizations

​
X-API-KEY
string
header
required

API key for authentication.

Body

application/json
​
currency
string

Card currency

​
brand
string

Card brand (e.g. mastercard)

​
amount
integer

Initial funding amount

​
wallet_id
string

Wallet ID to fund from

Response

200 - Success

​
status
boolean
​
data
object
​
error
any[]
​
message
string