Help & getting started
Everything you need to integrate, go live, and (optionally) onboard your own resellers. Apply for distribution
Step-by-step
- 1
Apply
Submit the distribution application with your business and platform details. We'll email you a secure link to your sandbox workspace.
- 2
Open your sandbox workspace
The email link takes you straight to your sandbox portal — no separate account or password needed, the link itself is your access.
- 3
Generate a sandbox API key
Create a key from the sandbox portal. The full credential is shown once — copy it into your secrets manager immediately, it can't be displayed again.
- 4
Integrate and test
Call the account, catalog, and transactions endpoints with your sandbox key. Sandbox transactions are fully simulated — no real supplier order is ever created, so you can test freely.
- 5
Go live
Once your integration is working, contact partners@popularvouchers.com for production approval. We'll set up your production account with a real pricing region and currency.
- 6
Fund your balance
Production transactions debit a prepaid balance. Arrange funding with our team; each credit is idempotent by reference, so a retried payment notification never double-credits you.
- 7
Set your discount
Your account has a discount off published price, configured by our team — this is your cost basis on every product.
- 8
Create resellers (optional)
If you're onboarding sub-resellers under your account, create each one, set their default margin (it can never exceed your own discount), and optionally restrict them to specific countries or product categories.
- 9
Fund and manage your resellers
Credit a reseller's balance once they've paid you, and generate their first portal login — they'll be emailed a temporary password and are required to set up two-factor authentication before they can do anything else.
- 10
Monitor
Check your balance, transaction history, and ledger any time via the account and transactions endpoints.
Frequently asked questions
What's the difference between sandbox and production?+
Sandbox transactions are entirely simulated — no supplier is ever contacted and no real voucher is delivered, so you can integrate and test without risk. Production transactions are real and debit your real prepaid balance.
How is pricing determined?+
Every product has a published price, and your account has a discount off that price — this is what you're charged. If you have resellers, each one's margin is also a discount off the same published price, and it can never exceed your own discount.
What currency do I transact in?+
The currency tied to your account's pricing region, set when your production account is created.
How do I fund my balance?+
Arrange this with our team directly. Credits are idempotent by reference, so a retried or duplicated payment notification is never applied twice.
What is a reseller, and do I have to use them?+
A reseller is a sub-account under you with its own prepaid balance and margin — useful if you want to let others sell through your account without sharing your own API credentials. Entirely optional.
How much margin can I give a reseller?+
Up to, but never more than, your own discount. If your discount is 8%, you can give a reseller anywhere from 0% up to 8% — the difference is what you keep on that sale.
Can a reseller change their own margin?+
No — only you (or our support team on your behalf) can set a reseller's margin, whether their default rate or an override for a specific product.
What happens if a purchase fails after payment?+
It's automatically refunded to the originating balance (yours, or the reseller's if the sale was theirs) and you'll get an email with the reason. No manual reconciliation needed.
Is my API key secure? What's the IP allowlist for?+
Keys are hashed at rest and only shown once at creation. The optional IP allowlist restricts a key to specific server addresses — useful if your integration always runs from a fixed IP, but it's an additive layer, never a substitute for keeping the key itself secret.
How do I rotate or revoke a key?+
Generate a new key, update your integration, then revoke the old one — all from your sandbox or production portal.
Who do I contact for help?+
partners@popularvouchers.com for account, pricing, and reseller setup questions; support@popularvouchers.com for anything else.