Validate gift card
curl --request POST \
--url https://api.example.com/ValidateGiftCard \
--header 'Content-Type: application/json' \
--data '
{
"MerchantGUID": " ",
"ShippingCountryCode": "UA",
"CardFields": {
"CardId": "card10",
"CardPin": "111"
}
}
'import requests
url = "https://api.example.com/ValidateGiftCard"
payload = {
"MerchantGUID": " ",
"ShippingCountryCode": "UA",
"CardFields": {
"CardId": "card10",
"CardPin": "111"
}
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
MerchantGUID: ' ',
ShippingCountryCode: 'UA',
CardFields: {CardId: 'card10', CardPin: '111'}
})
};
fetch('https://api.example.com/ValidateGiftCard', 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.example.com/ValidateGiftCard",
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([
'MerchantGUID' => ' ',
'ShippingCountryCode' => 'UA',
'CardFields' => [
'CardId' => 'card10',
'CardPin' => '111'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$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.example.com/ValidateGiftCard"
payload := strings.NewReader("{\n \"MerchantGUID\": \" \",\n \"ShippingCountryCode\": \"UA\",\n \"CardFields\": {\n \"CardId\": \"card10\",\n \"CardPin\": \"111\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
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.example.com/ValidateGiftCard")
.header("Content-Type", "application/json")
.body("{\n \"MerchantGUID\": \" \",\n \"ShippingCountryCode\": \"UA\",\n \"CardFields\": {\n \"CardId\": \"card10\",\n \"CardPin\": \"111\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/ValidateGiftCard")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"MerchantGUID\": \" \",\n \"ShippingCountryCode\": \"UA\",\n \"CardFields\": {\n \"CardId\": \"card10\",\n \"CardPin\": \"111\"\n }\n}"
response = http.request(request)
puts response.read_body{
"IsValid": true,
"Balance": 1000,
"CurrencyCode": "GBP",
"IsGlobalEGiftCard": false
}Gift Cards
Validate gift card
Use the Validate Gift Card API call to send gift card data to the platform. In return, the Platform sends the card amount and approves that the card is valid.
POST
/
ValidateGiftCard
Validate gift card
curl --request POST \
--url https://api.example.com/ValidateGiftCard \
--header 'Content-Type: application/json' \
--data '
{
"MerchantGUID": " ",
"ShippingCountryCode": "UA",
"CardFields": {
"CardId": "card10",
"CardPin": "111"
}
}
'import requests
url = "https://api.example.com/ValidateGiftCard"
payload = {
"MerchantGUID": " ",
"ShippingCountryCode": "UA",
"CardFields": {
"CardId": "card10",
"CardPin": "111"
}
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
MerchantGUID: ' ',
ShippingCountryCode: 'UA',
CardFields: {CardId: 'card10', CardPin: '111'}
})
};
fetch('https://api.example.com/ValidateGiftCard', 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.example.com/ValidateGiftCard",
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([
'MerchantGUID' => ' ',
'ShippingCountryCode' => 'UA',
'CardFields' => [
'CardId' => 'card10',
'CardPin' => '111'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$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.example.com/ValidateGiftCard"
payload := strings.NewReader("{\n \"MerchantGUID\": \" \",\n \"ShippingCountryCode\": \"UA\",\n \"CardFields\": {\n \"CardId\": \"card10\",\n \"CardPin\": \"111\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
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.example.com/ValidateGiftCard")
.header("Content-Type", "application/json")
.body("{\n \"MerchantGUID\": \" \",\n \"ShippingCountryCode\": \"UA\",\n \"CardFields\": {\n \"CardId\": \"card10\",\n \"CardPin\": \"111\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/ValidateGiftCard")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"MerchantGUID\": \" \",\n \"ShippingCountryCode\": \"UA\",\n \"CardFields\": {\n \"CardId\": \"card10\",\n \"CardPin\": \"111\"\n }\n}"
response = http.request(request)
puts response.read_body{
"IsValid": true,
"Balance": 1000,
"CurrencyCode": "GBP",
"IsGlobalEGiftCard": false
}Part of the Gift Cards integration guide — see it for when and how to use this endpoint.
Body
application/json
Response
200 - application/json
Validation result.
Flag which approves that the user entered the correct card data.
Available amount of money on the gift card.
Code of card currency.
If the card was bought from Global-e, should be true.
Code of platform error.
Message of platform error.
⌘I

