Verify & Retrieve Gift Card Order
curl --request GET \
--url https://api.laikipay.com/v1/merchant/gift-cards/verify/{reference} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.laikipay.com/v1/merchant/gift-cards/verify/{reference}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.laikipay.com/v1/merchant/gift-cards/verify/{reference}', 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.laikipay.com/v1/merchant/gift-cards/verify/{reference}",
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.laikipay.com/v1/merchant/gift-cards/verify/{reference}"
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.laikipay.com/v1/merchant/gift-cards/verify/{reference}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.laikipay.com/v1/merchant/gift-cards/verify/{reference}")
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_bodyGift Cards
Verify & Retrieve Gift Card Order
Verify fulfillment status and securely retrieve voucher code, PIN, and redemption instructions by reference
GET
/
gift-cards
/
verify
/
{reference}
Verify & Retrieve Gift Card Order
curl --request GET \
--url https://api.laikipay.com/v1/merchant/gift-cards/verify/{reference} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.laikipay.com/v1/merchant/gift-cards/verify/{reference}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.laikipay.com/v1/merchant/gift-cards/verify/{reference}', 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.laikipay.com/v1/merchant/gift-cards/verify/{reference}",
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.laikipay.com/v1/merchant/gift-cards/verify/{reference}"
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.laikipay.com/v1/merchant/gift-cards/verify/{reference}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.laikipay.com/v1/merchant/gift-cards/verify/{reference}")
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_bodyOverview
The/gift-cards/verify/{reference} endpoint queries the fulfillment state of a gift card order using its unique client or transaction reference.
If an order was initially in "PROCESSING" state, calling this endpoint triggers automated Transaction Status Query (TSQ) reconciliation with the upstream issuance network and returns the unlocked voucherCode and voucherPin.
Real-World Use Cases
Order Status Polling
Poll this endpoint if your client connection dropped during the initial
POST /gift-cards/purchase call to recover the voucher code without double-charging.Voucher Retrieval on User Request
Allow users to revisit their order history page inside your mobile app to re-copy their voucher PIN and view redemption instructions.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
reference | string | Yes | Client order reference (e.g. GC_ORD_89102) or internal transaction reference. |
Code Examples
curl -X GET "https://api.laikipay.com/v1/merchant/gift-cards/verify/GC_ORD_89102" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
import axios from 'axios';
async function verifyGiftCardOrder(accessToken, reference) {
const response = await axios.get(
`https://api.laikipay.com/v1/merchant/gift-cards/verify/${reference}`,
{
headers: { Authorization: `Bearer ${accessToken}` },
}
);
const { isSuccessful, voucher } = response.data;
console.log(`Order Status: ${isSuccessful ? 'SUCCESS' : 'PENDING'}`);
console.log(`Voucher: ${voucher?.code} (PIN: ${voucher?.pin})`);
return response.data;
}
import requests
def verify_gift_card(access_token, reference):
url = f"https://api.laikipay.com/v1/merchant/gift-cards/verify/{reference}"
headers = {"Authorization": f"Bearer {access_token}"}
response = requests.get(url, headers=headers)
response.raise_for_status()
order = response.json()
print(f"Status: {order['orderStatus']} | Voucher: {order.get('voucher', {}).get('code')}")
return order
Response Structure
Success Response (200 OK)
{
"status": "success",
"reference": "GC_ORD_89102",
"transactionId": "gco_78a10b9c",
"productCode": "LAI-AMZN-USA-001",
"productName": "Amazon US",
"currency": "USD",
"faceValue": 25.0,
"costNgn": 41615.0,
"voucher": {
"code": "AQ48-921829-LP902",
"pin": "4819",
"serialNumber": "SN-829102-AMZ",
"instructions": "Redeem online at amazon.com/redeem"
},
"recipient": {
"email": "david.adeleke@example.com",
"name": "David Adeleke"
},
"orderStatus": "SUCCESS",
"isSuccessful": true,
"environment": "TEST",
"createdAt": "2026-10-14T12:00:00.000Z"
}
Error Handling
404 Not Found — Order Not Found
404 Not Found — Order Not Found
{
"statusCode": 404,
"message": "Gift card order 'GC_ORD_invalid' not found",
"error": "Not Found"
}

