Skip to main content

Quick Start Guide

Get up and running with Azotte in just 5 steps.

Prerequisites​

  • Azotte account (sign up at azotte.com)
  • API key (generated in the Azotte Portal)
  • Basic understanding of REST APIs

Step 1: Create Your Tenant​

Every Azotte integration starts with a tenant - your isolated workspace.

curl -X POST https://api.azotte.com/v1/tenants \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Company",
    "settings": {
      "currency": "USD",
      "timezone": "UTC"
    }
  }'

Step 2: Configure Your Storefront​

Create a storefront to represent your sales channel.

curl -X POST https://api.azotte.com/v1/storefronts \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-tn: YOUR_TENANT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Web Store",
    "type": "web",
    "settings": {
      "theme": "default",
      "currency": "USD"
    }
  }'

Step 3: Create a Bundle​

Define what you're selling - products, services, or subscriptions.

curl -X POST https://api.azotte.com/v1/bundles \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-tn: YOUR_TENANT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Premium Plan",
    "description": "Access to premium features",
    "type": "subscription",
    "entitlements": ["premium_features", "priority_support"]
  }'

Step 4: Configure Pricing​

Set up pricing for your bundle.

curl -X POST https://api.azotte.com/v1/prices \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-tn: YOUR_TENANT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "bundleId": "BUNDLE_ID_FROM_STEP_3",
    "amount": 2999,
    "currency": "USD", 
    "interval": "monthly"
  }'

Step 5: Integrate Checkout​

Add Azotte checkout to your application.

Hosted Checkout (Simplest)​

<script src="https://js.azotte.com/v1/checkout.js"></script>
<button onclick="azotteCheckout.open({priceId: 'YOUR_PRICE_ID'})">
  Subscribe Now
</button>

Embedded Checkout​

<div id="azotte-checkout"></div>
<script>
  AzotteCheckout.create({
    priceId: 'YOUR_PRICE_ID',
    container: '#azotte-checkout'
  });
</script>

Next Steps​

🎉 Congratulations! You've successfully set up a basic Azotte integration.

Learn More​

Test Your Integration​

  • Use test API keys for development
  • Try different payment scenarios
  • Test subscription lifecycle events
  • Set up webhooks for real-time updates

Go Live​

  • Switch to production API keys
  • Configure production payment providers
  • Set up monitoring and alerts
  • Review security best practices