Get Card Link
curl --request GET \
--url https://api.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link \
--header 'X-Api-Key: <api-key>' \
--header 'X-Api-Secret: <api-key>'import requests
url = "https://api.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link"
headers = {
"X-Api-Key": "<api-key>",
"X-Api-Secret": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Api-Key': '<api-key>', 'X-Api-Secret': '<api-key>'}
};
fetch('https://api.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link', 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.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>",
"X-Api-Secret: <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"
"net/http"
"io"
)
func main() {
url := "https://api.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("X-Api-Secret", "<api-key>")
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.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link")
.header("X-Api-Key", "<api-key>")
.header("X-Api-Secret", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
request["X-Api-Secret"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"card_id": "9b1d3c52-0f0e-4a8e-b0b1-6f7a1c2d3e4f",
"url": "https://checkout.yativo.com/card-access/cl_Vq3eX9...",
"created_at": "2023-11-07T05:31:56Z",
"rotated_at": "2023-11-07T05:31:56Z"
}
}{
"status": "failed",
"status_code": 123,
"message": "Insufficient wallet balance",
"data": {
"error": "Insufficient wallet balance"
},
"error": {
"code": "invalid_argument",
"message": "<string>",
"request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
},
"error_details": {
"code": "validation_error",
"message": "The amount field is required.",
"http_status": 422,
"fields": {},
"retryable": false,
"retry_after": 123
}
}Corporate Card Links
Get Card Link
The card’s reusable, employee-only page for card details and PIN
GET
/
corporate-card
/
employees
/
cards
/
{card_id}
/
link
Get Card Link
curl --request GET \
--url https://api.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link \
--header 'X-Api-Key: <api-key>' \
--header 'X-Api-Secret: <api-key>'import requests
url = "https://api.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link"
headers = {
"X-Api-Key": "<api-key>",
"X-Api-Secret": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Api-Key': '<api-key>', 'X-Api-Secret': '<api-key>'}
};
fetch('https://api.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link', 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.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>",
"X-Api-Secret: <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"
"net/http"
"io"
)
func main() {
url := "https://api.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("X-Api-Secret", "<api-key>")
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.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link")
.header("X-Api-Key", "<api-key>")
.header("X-Api-Secret", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.yativo.com/api/v1/corporate-card/employees/cards/{card_id}/link")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
request["X-Api-Secret"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"card_id": "9b1d3c52-0f0e-4a8e-b0b1-6f7a1c2d3e4f",
"url": "https://checkout.yativo.com/card-access/cl_Vq3eX9...",
"created_at": "2023-11-07T05:31:56Z",
"rotated_at": "2023-11-07T05:31:56Z"
}
}{
"status": "failed",
"status_code": 123,
"message": "Insufficient wallet balance",
"data": {
"error": "Insufficient wallet balance"
},
"error": {
"code": "invalid_argument",
"message": "<string>",
"request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
},
"error_details": {
"code": "validation_error",
"message": "The amount field is required.",
"http_status": 422,
"fields": {},
"retryable": false,
"retry_after": 123
}
}Returns the card’s link. Only the card’s employee can open it, and it’s the only place the card number, CVV and PIN are available. Share it or embed it in an iframe. See Corporate Card Links for the employee flow, embedding and branding.
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Path Parameters
The card's card_id.
Query Parameters
One of your themes. Adds ?theme= to the URL so the page and its emails use it.

