Get card number, CVV and expiry
curl --request GET \
--url https://api.kemycard.com/v1/cards/{code}/sensitive \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.kemycard.com/v1/cards/{code}/sensitive"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.kemycard.com/v1/cards/{code}/sensitive', 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.kemycard.com/v1/cards/{code}/sensitive",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.kemycard.com/v1/cards/{code}/sensitive"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.kemycard.com/v1/cards/{code}/sensitive")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.kemycard.com/v1/cards/{code}/sensitive")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"card_code": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"display": "direct",
"card_pan_url": null,
"card_number": "4000000000000000",
"cvv": "000",
"expiry_month": 12,
"expiry_year": 2029,
"name_on_card": "John Doe"
},
"meta": {
"request_id": "a4f8e2c1b3d97056",
"mode": "test",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"success": false,
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Resource not found.",
"details": null
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Missing required fields.",
"details": {}
},
"meta": {
"request_id": "a4f8e2c1b3d97056",
"mode": "test",
"timestamp": "2023-11-07T05:31:56Z"
}
}Cards
Get Card Sensitive Data
Returns the full card number, the CVV and the expiry date. This is the only endpoint that returns them:
every other response only shows last_four.
Available once the card is active or frozen. Call it from your server, only when your customer needs
to see the card, and never store or log the response. The response is never cached.
Two display modes. Check display in the response (also given in advance by sensitive_data_display
on the card, and by sensitive_data on its product):
direct:card_number,cvv,expiry_monthandexpiry_yearare in the response. Show them to your customer.iframe: the card issuer no longer returns the card number and the CVV.card_numberandcvvarenull, andcard_pan_urlis the URL of a page to show in an<iframe>in the page of your customer (<iframe src="..." referrerpolicy="no-referrer">). The page displays the card details itself: they never go through your servers. The URL changes on every call and expires quickly: request a new one each time the customer opens the details, and never store or log it. It can only be displayed inside a page served over HTTPS (it does not load inhttp://localhost).
GET
/
cards
/
{code}
/
sensitive
Get card number, CVV and expiry
curl --request GET \
--url https://api.kemycard.com/v1/cards/{code}/sensitive \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.kemycard.com/v1/cards/{code}/sensitive"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.kemycard.com/v1/cards/{code}/sensitive', 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.kemycard.com/v1/cards/{code}/sensitive",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.kemycard.com/v1/cards/{code}/sensitive"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.kemycard.com/v1/cards/{code}/sensitive")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.kemycard.com/v1/cards/{code}/sensitive")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"card_code": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"display": "direct",
"card_pan_url": null,
"card_number": "4000000000000000",
"cvv": "000",
"expiry_month": 12,
"expiry_year": 2029,
"name_on_card": "John Doe"
},
"meta": {
"request_id": "a4f8e2c1b3d97056",
"mode": "test",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"success": false,
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "Resource not found.",
"details": null
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Missing required fields.",
"details": {}
},
"meta": {
"request_id": "a4f8e2c1b3d97056",
"mode": "test",
"timestamp": "2023-11-07T05:31:56Z"
}
}