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 '
{
"customer_id": "43a2b75e-5c59-429e-872a-2a54c7b17e34",
"currency": "ngn",
"brand": "mastercard",
"amount": 15000,
"wallet_id": "43a2b75e-5c59-429e-872a-2a54c7b17e37"
}
'import requests
url = "https://api.platnova.com/v1/cards/create"
payload = {
"customer_id": "43a2b75e-5c59-429e-872a-2a54c7b17e34",
"currency": "ngn",
"brand": "mastercard",
"amount": 15000,
"wallet_id": "43a2b75e-5c59-429e-872a-2a54c7b17e37"
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
customer_id: '43a2b75e-5c59-429e-872a-2a54c7b17e34',
currency: 'ngn',
brand: 'mastercard',
amount: 15000,
wallet_id: '43a2b75e-5c59-429e-872a-2a54c7b17e37'
})
};
fetch('https://api.platnova.com/v1/cards/create', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.platnova.com/v1/cards/create",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'customer_id' => '43a2b75e-5c59-429e-872a-2a54c7b17e34',
'currency' => 'ngn',
'brand' => 'mastercard',
'amount' => 15000,
'wallet_id' => '43a2b75e-5c59-429e-872a-2a54c7b17e37'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platnova.com/v1/cards/create"
payload := strings.NewReader("{\n \"customer_id\": \"43a2b75e-5c59-429e-872a-2a54c7b17e34\",\n \"currency\": \"ngn\",\n \"brand\": \"mastercard\",\n \"amount\": 15000,\n \"wallet_id\": \"43a2b75e-5c59-429e-872a-2a54c7b17e37\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.platnova.com/v1/cards/create")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"customer_id\": \"43a2b75e-5c59-429e-872a-2a54c7b17e34\",\n \"currency\": \"ngn\",\n \"brand\": \"mastercard\",\n \"amount\": 15000,\n \"wallet_id\": \"43a2b75e-5c59-429e-872a-2a54c7b17e37\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.platnova.com/v1/cards/create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"customer_id\": \"43a2b75e-5c59-429e-872a-2a54c7b17e34\",\n \"currency\": \"ngn\",\n \"brand\": \"mastercard\",\n \"amount\": 15000,\n \"wallet_id\": \"43a2b75e-5c59-429e-872a-2a54c7b17e37\"\n}"
response = http.request(request)
puts response.read_body{
"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"
}{
"status": false,
"data": {},
"error": [],
"message": "only 1 mastercard card allowed in a month"
}Cards
Create Card
Create a virtual card for a customer with optional initial funding.
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 '
{
"customer_id": "43a2b75e-5c59-429e-872a-2a54c7b17e34",
"currency": "ngn",
"brand": "mastercard",
"amount": 15000,
"wallet_id": "43a2b75e-5c59-429e-872a-2a54c7b17e37"
}
'import requests
url = "https://api.platnova.com/v1/cards/create"
payload = {
"customer_id": "43a2b75e-5c59-429e-872a-2a54c7b17e34",
"currency": "ngn",
"brand": "mastercard",
"amount": 15000,
"wallet_id": "43a2b75e-5c59-429e-872a-2a54c7b17e37"
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
customer_id: '43a2b75e-5c59-429e-872a-2a54c7b17e34',
currency: 'ngn',
brand: 'mastercard',
amount: 15000,
wallet_id: '43a2b75e-5c59-429e-872a-2a54c7b17e37'
})
};
fetch('https://api.platnova.com/v1/cards/create', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.platnova.com/v1/cards/create",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'customer_id' => '43a2b75e-5c59-429e-872a-2a54c7b17e34',
'currency' => 'ngn',
'brand' => 'mastercard',
'amount' => 15000,
'wallet_id' => '43a2b75e-5c59-429e-872a-2a54c7b17e37'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platnova.com/v1/cards/create"
payload := strings.NewReader("{\n \"customer_id\": \"43a2b75e-5c59-429e-872a-2a54c7b17e34\",\n \"currency\": \"ngn\",\n \"brand\": \"mastercard\",\n \"amount\": 15000,\n \"wallet_id\": \"43a2b75e-5c59-429e-872a-2a54c7b17e37\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.platnova.com/v1/cards/create")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"customer_id\": \"43a2b75e-5c59-429e-872a-2a54c7b17e34\",\n \"currency\": \"ngn\",\n \"brand\": \"mastercard\",\n \"amount\": 15000,\n \"wallet_id\": \"43a2b75e-5c59-429e-872a-2a54c7b17e37\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.platnova.com/v1/cards/create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"customer_id\": \"43a2b75e-5c59-429e-872a-2a54c7b17e34\",\n \"currency\": \"ngn\",\n \"brand\": \"mastercard\",\n \"amount\": 15000,\n \"wallet_id\": \"43a2b75e-5c59-429e-872a-2a54c7b17e37\"\n}"
response = http.request(request)
puts response.read_body{
"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"
}{
"status": false,
"data": {},
"error": [],
"message": "only 1 mastercard card allowed in a month"
}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
API key for authentication.
Body
application/json
⌘I

