Quickstart
Take a real payment in the Unipaas sandbox with a single server-to-server call, no vendor setup and no onboarding. You create a checkout, open the link Unipaas returns, and pay it with a test card. That same call hands you everything you need to choose your integration path next.
Before you start
Section titled “Before you start”- A sandbox account. Create one; it is free and instant.
- Your sandbox private key, from your portal account settings.
- The sandbox base URL:
https://sandbox.unipaas.com/platform.
Create a checkout
Section titled “Create a checkout”Make one call from your server to create a checkout. It takes your private key in the
Authorization header and four fields: the amount, the currency, the shopper’s country, and their
email. Amounts are in the major currency unit, so 10 is 10.00.
curl -X POST https://sandbox.unipaas.com/platform/pay-ins/checkout \ -H "Authorization: Bearer <PLATFORM_API_KEY>" \ -H "Content-Type: application/json" \ -d '{ "amount": 10, "currency": "GBP", "country": "GB", "email": "shopper@example.com" }'See it work
Section titled “See it work”Unipaas responds with 201 Created and the checkout object. Two fields matter right now:
{ "id": "6839...c1d", "status": "open", "amount": 10, "currency": "GBP", "shortLink": "https://sandbox-checkout.unipaas.com/-0_lisK298/", "sessionToken": "eyJhbGciOiJI...", "expiresAt": "2026-06-25T18:30:00.000Z"}shortLinkis a hosted checkout page. Open it in your browser.sessionTokenis a short-lived token for the embedded Web SDK path; you use it below.
Open the shortLink. You will see a branded, PCI-compliant checkout for the amount you set. Pay it
with a test card to complete your first sandbox payment.
Next steps
Section titled “Next steps”You have taken a payment. Now choose how to integrate:
- Hosted checkout - redirect shoppers to the
shortLinkyou just used. See Checkout Page. - Embedded Web SDK - keep shoppers on your page with Unipaas-hosted secure card fields, using the
sessionTokenfrom the call above. See Web SDK. - Client-side calls - if your app calls Unipaas from the browser, such as embedded onboarding, mint a scoped token first. See Authentication.