Getting Started

Welcome.
This guide shows you how to make your first Storrik API request using a secret API key, check your authentication, and create your first payment intent for hosted checkout.

1. Get Your API Keys

Storrik uses two types of API keys:

• Public keys for client side usage
• Secret keys for backend usage with full access

You can create, rotate, or revoke keys from your dashboard at any time.

To authenticate, send your key as a Bearer token:

Authorization: Bearer sk_live_123

2. Create Your First Payment Intent

You can now create a payment intent.
Hosted mode returns a redirect url for checkout.

curl https://api.storrik.io/v1/payments/intents \
  -H "Authorization: Bearer sk_live_123" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "hosted",
    "amount": 2500,
    "currency": "usd",
    "email": "foo@bar.com",
  }'

Example Response:

{
  "ok": true,
  "url": "https://checkout.storrik.io/p/12345678"
}

3. API Versioning

Every response includes the API version used to process the request.

api-version: 2025-11-07.alpha

To use a specific version for your request, send the header:

api-version: 2025-11-07.alpha

If no version is provided, the latest stable build is used automatically. You can also change your default API version directly from the dashboard.

4. Next Steps

• Learn about Authentication in detail.
• Review Rate Limits.
• Explore the Payments API.