Skip to main content
POST
/
v1
/
cards
/
create
Create card
curl --request POST \
  --url https://api.platnova.com/v1/cards/create \
  --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 virtual card for a customer. This endpoint allows you to issue a new virtual card with a specified currency, brand, and initial funding amount. A wallet_id and amount can be optionally specified to change the default currency funding wallet and initial amount in the card respectively. 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