Before you start
The integration runs in two environments: staging and production. You build and validate everything in staging first — login, webhooks, signature, and opening the system — and then go live in production. For the full step-by-step order, see the Integration overview.
Environments
- Staging — where you do the entire integration: log in, implement and validate your two webhooks, pass our QA, and open the system. You build and test here until everything works.
- Production — enabled at go-live, after your staging integration is validated. You receive separate production credentials and the production host at that point.
Staging and production use different hosts and different credentials. We provide both privately, together with your credentials — they are not published in this documentation.
Credentials and how you receive them
We provide your API credentials (a username and password) and the host for each environment privately, after your onboarding with Apuestería.
With your staging credentials, login works immediately — you can build and test login right away, even before anything else is in place. Opening the system (the iframe) stays gated until your webhooks pass QA; see the Integration overview for the order and Step 3 · Launch the system for what to expect.
We deliver your credentials through a one-time link. It burns on first open, so treat it carefully:
- Before opening it, have somewhere ready to store the credentials securely — ideally a password manager.
- Open it only once. After you open it, you cannot view the credentials again through that link.
- If the link has expired or was already opened, contact your Apuestería contact and they'll generate a new one.
What you'll need ready
- Your two webhook endpoints — deposits and withdrawals — reachable over HTTPS and implementing signature validation. See Step 2 · Webhooks and Signature.
- A secure place to store the credentials you'll receive through the one-time link.
Next step
When you're ready, head to Step 1 · Login to begin.