curl --request GET \
--url https://api.wizzgift.com/retailer/v1/checkouts/{checkoutId} \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.wizzgift.com/retailer/v1/checkouts/{checkoutId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.wizzgift.com/retailer/v1/checkouts/{checkoutId}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.wizzgift.com/retailer/v1/checkouts/{checkoutId}",
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>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"checkoutId": "<string>",
"customerEmail": "<string>",
"status": "pending",
"totalAmount": 123,
"paymentCurrency": "<string>",
"items": [
{
"id": "<string>",
"productId": "<string>",
"productName": "<string>",
"skuId": "<string>",
"unitAmount": 123,
"unitPrice": 123,
"quantity": 123,
"status": "pending",
"checkoutId": "<string>",
"productImageUrl": "<string>",
"productBrandColor": "<string>",
"unitMarkup": 123,
"requiredFields": {},
"fulfillments": [
{
"index": 123,
"status": "<string>",
"sealed": true,
"giftCardId": "<string>",
"cardCode": "<string>",
"cardPin": "<string>",
"cardUrl": "<string>",
"vendorOrderId": "<string>",
"TxId": "<string>",
"expiresAt": 1753142400000,
"errorMessage": "<string>",
"fulfilledAt": 1753142400000
}
],
"createdAt": 1753142400000,
"updatedAt": 1753142400000
}
],
"createdAt": 1753142400000,
"payment": {
"state": "pending",
"confirmedAmount": 123,
"totalAmount": 123,
"currency": "<string>",
"payments": [
{
"paymentId": "<string>",
"method": "Bitcoin",
"amount": 123,
"status": "pending",
"createdAt": 1753142400000,
"confirmedAt": 1753142400000,
"partialPayment": {
"sentAmount": 123,
"expectedAmount": 123,
"currency": "<string>"
}
}
]
},
"externalRef": "<string>",
"markupTotal": 123,
"sealCards": true,
"callbackUrl": "<string>",
"country": "<string>",
"completedAt": 1753142400000,
"expiredAt": 1753142400000,
"updatedAt": 1753142400000
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or expired API key"
},
"requestId": "req_8f3k2"
}{
"error": {
"code": "NOT_FOUND",
"message": "Checkout not found"
},
"requestId": "req_8f3k2"
}{
"error": "Too many requests",
"message": "<string>"
}Get checkout — order status, payment state and codes (one poll endpoint)
Everything in one response: order status, aggregate payment state
(including crypto partial-payment progress), items, and card codes in
items[].fulfillments[] once fulfilled (unless sealed). This is also
the endpoint to call when a webhook arrives. Foreign or B2B checkout
ids return 404.
curl --request GET \
--url https://api.wizzgift.com/retailer/v1/checkouts/{checkoutId} \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.wizzgift.com/retailer/v1/checkouts/{checkoutId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.wizzgift.com/retailer/v1/checkouts/{checkoutId}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.wizzgift.com/retailer/v1/checkouts/{checkoutId}",
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>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"checkoutId": "<string>",
"customerEmail": "<string>",
"status": "pending",
"totalAmount": 123,
"paymentCurrency": "<string>",
"items": [
{
"id": "<string>",
"productId": "<string>",
"productName": "<string>",
"skuId": "<string>",
"unitAmount": 123,
"unitPrice": 123,
"quantity": 123,
"status": "pending",
"checkoutId": "<string>",
"productImageUrl": "<string>",
"productBrandColor": "<string>",
"unitMarkup": 123,
"requiredFields": {},
"fulfillments": [
{
"index": 123,
"status": "<string>",
"sealed": true,
"giftCardId": "<string>",
"cardCode": "<string>",
"cardPin": "<string>",
"cardUrl": "<string>",
"vendorOrderId": "<string>",
"TxId": "<string>",
"expiresAt": 1753142400000,
"errorMessage": "<string>",
"fulfilledAt": 1753142400000
}
],
"createdAt": 1753142400000,
"updatedAt": 1753142400000
}
],
"createdAt": 1753142400000,
"payment": {
"state": "pending",
"confirmedAmount": 123,
"totalAmount": 123,
"currency": "<string>",
"payments": [
{
"paymentId": "<string>",
"method": "Bitcoin",
"amount": 123,
"status": "pending",
"createdAt": 1753142400000,
"confirmedAt": 1753142400000,
"partialPayment": {
"sentAmount": 123,
"expectedAmount": 123,
"currency": "<string>"
}
}
]
},
"externalRef": "<string>",
"markupTotal": 123,
"sealCards": true,
"callbackUrl": "<string>",
"country": "<string>",
"completedAt": 1753142400000,
"expiredAt": 1753142400000,
"updatedAt": 1753142400000
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or expired API key"
},
"requestId": "req_8f3k2"
}{
"error": {
"code": "NOT_FOUND",
"message": "Checkout not found"
},
"requestId": "req_8f3k2"
}{
"error": "Too many requests",
"message": "<string>"
}Authorizations
API key (wg_live_…) created in the dashboard (Account → API Keys).
Shown once at creation; only a hash is stored server-side.
Path Parameters
Checkout/order id.
Response
Checkout with payment state.
The end-customer's email.
Order lifecycle. partial = some items fulfilled, some failed. expired = never paid.
pending, processing, completed, partial, failed, expired What the end-customer pays, in paymentCurrency (markup included).
Show child attributes
Show child attributes
Unix timestamp in milliseconds (UTC).
1753142400000
Aggregate payment state; null before any payment exists.
Show child attributes
Show child attributes
Your total markup on this checkout, in USD. Credited to your balance as items complete.
The customerCountry you supplied.
Unix timestamp in milliseconds (UTC).
1753142400000
Unix timestamp in milliseconds (UTC).
1753142400000
Unix timestamp in milliseconds (UTC).
1753142400000