Sign in
Giftronaut API

Guides

In-depth guides for common integration scenarios.

Authentication

Learn how to obtain and use OAuth2 access tokens for the API.

Making requests

Understand request format, headers, and base URLs.

Pagination

Navigate large result sets using page and pageSize parameters.

Errors

Understand error codes, status codes, and how to handle them.

Recipient Email Verification

How Giftronaut's built-in magic link verification protects gift card redemption — zero implementation required.

Webhooks

Receive real-time HTTP notifications for order events, balance alerts, and more.

W-9 Tax Collection

How US W-9 collection works — enabled in the portal, applied automatically to orders you place via the API and MCP.

Idempotency

Use idempotency keys to safely retry failed requests without accidentally creating duplicate orders.

Rate limits

Understand the request limits for each environment and how to handle 429 Too Many Requests responses gracefully.

Sandbox vs Production

Giftronaut provides two isolated environments. Build and test in Sandbox before promoting your integration to Production.

Choose a card type

Giftronaut supports two card types: Branded Card and Choice Card.

Set up your delivery email

All gift cards are delivered by email. You can customize the sender name, subject line, message, brand logo, and colors using an email template.

Specify your recipients

There are two ways to specify recipients. For a quick one-off send, include them inline. For recurring sends, build an address book.

Sending Rewards

Sending a gift card reward involves four steps: choosing a card type, setting up a delivery email, specifying your recipients, and placing the order.

Balance & funding

Giftronaut uses a prepaid balance model. Top up your account before placing orders — every successful order deducts the order amount from your balance in real time.

Giftronaut Glossary

Key terms you'll encounter across the Giftronaut API and dashboard.

Refund Option

Maximize your campaign ROI by enabling the Refund Option — receive 50% of unredeemed funds back to your account when gift cards expire.