Production Access

1. Register a production account

Sign up at https://biz.sodagift.com. Production is completely separate from Sandbox — separate account, separate API keys, separate catalog and data.

2. Complete KYC review

Production API keys can only be generated after your KYC (Know Your Customer) review is complete.

1. In the production dashboard, go to Settings > Developer Settings and click Generate API Key — you'll be prompted to submit business documentation (e.g. articles of incorporation, W-9, or a bank verification letter).
2. Once the review is approved, generate your sodagift_live_ API key from the same screen.

• Review time: usually 1–2 business days; up to a week if we need more information. Your SodaGift representative can help expedite.
• Restrictions: certain business types (e.g. cryptocurrency, gambling) are not supported. Contact [email protected] for the full list.

3. Switch your integration to production

• Base URL: https://biz-sandbox-api.sodagift.com → https://biz-api.sodagift.com
• API key: sodagift_test_... → sodagift_live_...
• Re-fetch the product catalog against production — product IDs differ between environments. Never reuse Sandbox product IDs.
• Fund your account before your first live order (Funding); orders fail with account_balance_insufficient otherwise.

Go-live checklist

• API key stored in a secret manager, not in code
• Every POST /v1/orders sends an external_reference_id (Idempotency & retries)
• 429 and order_retry_needed handled with retry/backoff (Errors)
• Client throttled under 10 req/s (Rate limiting)
• Product availability checked (ON_SALE) before ordering
• Balance monitored — top up before large sends
• Voucher links/codes handled as secrets and never logged