How do I integrate Core Checkout on my website?
Prerequisites
Before starting the integration, make sure you have:
- An active Core Payment account (or sandbox access)
- A developer available for the integration
- Your secret API key, available in your dashboard under Developer → Configuration
Where to find the documentation?
All technical documentation is available here:
👉 documentation.corebycarlo.com
It covers:
- Authentication via secret key
- Creating a payment session
- Webhook management (payment confirmation)
- Errors and response codes
Sandbox vs production environment
Sandbox | Production | |
|---|---|---|
Purpose | Test the integration | Process real payments |
Access | Provided at onboarding | Provided after KYC validation + T&Cs signing |
API key | Test key (Developer → Configuration) | Live key (Developer → Configuration) |
Cards | Test cards in the API documentation | Real bank cards |
Set your webhook in each environment
Your webhook URL is set in Developer → Configuration → Webhooks. There is one URL per account, used for all statuses. The URL set in the sandbox does not carry over to production: enter it again on your production account. Without it, payments complete but no callback is sent to your server.
Going live
The switch to production happens once:
- ✅ Your KYC application has been validated
- ✅ The liveness check has been completed
- ✅ The terms and conditions have been signed electronically
Our team will then send your live credentials by email.
Updated on: 28/10/2026