curl https://api.thanxsandbox.com/gift_cards \
-X POST \
-H "Content-Type: application/json" \
-H "Accept-Version: v4.0" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${token}" \
-H "X-ClientId: ${client_id}" \
-d '{
"provider_id": "prov123merchant",
"card_number": "1234567890123456",
"pin": "1234"
}'
curl https://api.thanxsandbox.com/gift_cards \
-X POST \
-H "Content-Type: application/json" \
-H "Accept-Version: v4.0" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${token}" \
-H "X-ClientId: ${client_id}" \
-d '{
"provider_id": "prov123merchant",
"card_number": "9876543210987654"
}'
{
"gift_card": {
"id": "abc123def456",
"provider_id": "prov123merchant",
"card_number": "1234567890123456",
"pin": "1234",
"last4": "3456",
"balance": 50.00,
"state": "active",
"expires_at": "2026-12-31T23:59:59Z",
"created_at": "2024-12-15T10:00:00Z"
}
}
{
"error": "This gift card has already been added"
}
Gift Cards
Create Gift Card
This endpoint adds a new gift card to a user’s account.
POST
/
gift_cards
curl https://api.thanxsandbox.com/gift_cards \
-X POST \
-H "Content-Type: application/json" \
-H "Accept-Version: v4.0" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${token}" \
-H "X-ClientId: ${client_id}" \
-d '{
"provider_id": "prov123merchant",
"card_number": "1234567890123456",
"pin": "1234"
}'
curl https://api.thanxsandbox.com/gift_cards \
-X POST \
-H "Content-Type: application/json" \
-H "Accept-Version: v4.0" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${token}" \
-H "X-ClientId: ${client_id}" \
-d '{
"provider_id": "prov123merchant",
"card_number": "9876543210987654"
}'
{
"gift_card": {
"id": "abc123def456",
"provider_id": "prov123merchant",
"card_number": "1234567890123456",
"pin": "1234",
"last4": "3456",
"balance": 50.00,
"state": "active",
"expires_at": "2026-12-31T23:59:59Z",
"created_at": "2024-12-15T10:00:00Z"
}
}
{
"error": "This gift card has already been added"
}
This endpoint allows users to add a gift card to their account. The card is validated with the gift card provider and the balance is checked before the card is stored. The system prevents duplicate cards — the same card number cannot be added twice for the same user and merchant.
Please review proper request headers here.
Body
The provider merchant ID. This identifies which gift card provider and merchant configuration to use for validation.
Response
Current balance on the gift card (fetched in real-time from provider). May be null in list responses if provider is unavailable.
curl https://api.thanxsandbox.com/gift_cards \
-X POST \
-H "Content-Type: application/json" \
-H "Accept-Version: v4.0" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${token}" \
-H "X-ClientId: ${client_id}" \
-d '{
"provider_id": "prov123merchant",
"card_number": "1234567890123456",
"pin": "1234"
}'
curl https://api.thanxsandbox.com/gift_cards \
-X POST \
-H "Content-Type: application/json" \
-H "Accept-Version: v4.0" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${token}" \
-H "X-ClientId: ${client_id}" \
-d '{
"provider_id": "prov123merchant",
"card_number": "9876543210987654"
}'
{
"gift_card": {
"id": "abc123def456",
"provider_id": "prov123merchant",
"card_number": "1234567890123456",
"pin": "1234",
"last4": "3456",
"balance": 50.00,
"state": "active",
"expires_at": "2026-12-31T23:59:59Z",
"created_at": "2024-12-15T10:00:00Z"
}
}
{
"error": "This gift card has already been added"
}