curl -X POST https://api.swiftpay.cx/api/checkout/sessions \
  -H "Authorization: Bearer mp_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Coffee Subscription - Premium Package",
    "customer": {
      "email": "customer@example.com"
    },
    "askShipping": true,
    "urls": {
      "success": "https://yoursite.com/success",
      "cancel": "https://yoursite.com/cancel",
      "failure": "https://yoursite.com/payment-failed"
    },
    "items": [
      {
        "name": "Premium Coffee Beans",
        "description": "Ethiopian Yirgacheffe - Light Roast",
        "price": 24.99,
        "quantity": 2,
        "imageUrl": "https://yoursite.com/images/coffee.jpg"
      },
      {
        "name": "Shipping",
        "description": null,
        "price": 5.00,
        "quantity": 1,
        "imageUrl": null
      }
    ],
    "metadata": {
      "orderId": "ORD-2026-12345",
      "subscriptionId": "sub_premium_monthly",
      "customerTier": "gold",
      "isFirstOrder": true,
      "referralCode": "FRIEND20"
    }
  }'

// Using object metadata (recommended)
const response = await fetch("https://api.swiftpay.cx/api/checkout/sessions", {
   method: "POST",
   headers: {
      Authorization: "Bearer mp_live_your_api_key",
      "Content-Type": "application/json",
   },
   body: JSON.stringify({
      description: "Coffee Subscription - Premium Package",
      customer: {
         email: "customer@example.com",
      },
      askShipping: true,
      urls: {
         success: "https://yoursite.com/success",
         cancel: "https://yoursite.com/cancel",
         failure: "https://yoursite.com/payment-failed",
      },
      items: [
         {
            name: "Premium Coffee Beans",
            description: "Ethiopian Yirgacheffe - Light Roast",
            price: 24.99,
            quantity: 2,
            imageUrl: "https://yoursite.com/images/coffee.jpg",
         },
         {
            name: "Shipping",
            description: null,
            price: 5.0,
            quantity: 1,
            imageUrl: null,
         },
      ],
      metadata: {
         orderId: "ORD-2026-12345",
         subscriptionId: "sub_premium_monthly",
         customerTier: "gold",
         isFirstOrder: true,
         referralCode: "FRIEND20",
      },
   }),
});

const session = await response.json();

// Redirect customer to checkout
window.location.href = session.data.checkoutUrl;

// Alternative: Using array metadata format
const response = await fetch("https://api.swiftpay.cx/api/checkout/sessions", {
   method: "POST",
   headers: {
      Authorization: "Bearer mp_live_your_api_key",
      "Content-Type": "application/json",
   },
   body: JSON.stringify({
      description: "Coffee Subscription - Premium Package",
      customer: {
         email: "customer@example.com",
      },
      askShipping: false,
      urls: {
         success: "https://yoursite.com/success",
         cancel: null,
         failure: null,
      },
      items: [
         {
            name: "Premium Coffee Beans",
            description: "Ethiopian Yirgacheffe",
            price: 24.99,
            quantity: 1,
            imageUrl: null,
         },
      ],
      // Metadata as array (useful for dynamic forms)
      metadata: [
         { key: "orderId", value: "ORD-12345" },
         { key: "priority", value: 1 },
         { key: "isGift", value: false },
      ],
   }),
});

const session = await response.json();

import requests

response = requests.post(
    'https://api.swiftpay.cx/api/checkout/sessions',
    headers={
        'Authorization': 'Bearer mp_live_your_api_key',
        'Content-Type': 'application/json'
    },
    json={
        'description': 'Coffee Subscription - Premium Package',
        'customer': {
            'email': 'customer@example.com'
        },
        'askShipping': True,
        'urls': {
            'success': 'https://yoursite.com/success',
            'cancel': 'https://yoursite.com/cancel',
            'failure': 'https://yoursite.com/payment-failed'
        },
        'items': [
            {
                'name': 'Premium Coffee Beans',
                'description': 'Ethiopian Yirgacheffe - Light Roast',
                'price': 24.99,
                'quantity': 2,
                'imageUrl': 'https://yoursite.com/images/coffee.jpg'
            },
            {
                'name': 'Shipping',
                'description': None,
                'price': 5.00,
                'quantity': 1,
                'imageUrl': None
            }
        ],
        'metadata': {
            'orderId': 'ORD-2026-12345',
            'subscriptionId': 'sub_premium_monthly',
            'customerTier': 'gold',
            'isFirstOrder': True,
            'referralCode': 'FRIEND20'
        }
    }
)

session = response.json()
checkout_url = session['data']['checkoutUrl']

# Redirect user to checkout_url
print(f"Checkout URL: {checkout_url}")

<?php

$ch = curl_init('https://api.swiftpay.cx/api/checkout/sessions');

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer mp_live_your_api_key',
    'Content-Type: application/json'
]);

curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'description' => 'Coffee Subscription - Premium Package',
    'customer' => [
        'email' => 'customer@example.com'
    ],
    'askShipping' => true,
    'urls' => [
        'success' => 'https://yoursite.com/success',
        'cancel' => 'https://yoursite.com/cancel',
        'failure' => 'https://yoursite.com/payment-failed'
    ],
    'items' => [
        [
            'name' => 'Premium Coffee Beans',
            'description' => 'Ethiopian Yirgacheffe - Light Roast',
            'price' => 24.99,
            'quantity' => 2,
            'imageUrl' => 'https://yoursite.com/images/coffee.jpg'
        ],
        [
            'name' => 'Shipping',
            'description' => null,
            'price' => 5.00,
            'quantity' => 1,
            'imageUrl' => null
        ]
    ],
    'metadata' => [
        'orderId' => 'ORD-2026-12345',
        'subscriptionId' => 'sub_premium_monthly',
        'customerTier' => 'gold',
        'isFirstOrder' => true,
        'referralCode' => 'FRIEND20'
    ]
]));

$response = curl_exec($ch);
$session = json_decode($response, true);

curl_close($ch);

// Redirect to checkout
header('Location: ' . $session['data']['checkoutUrl']);
?>

{
  "success": true,
  "data": {
    "id": "01936d2e-8f4a-7b3c-9e5f-2a1c8d9b6e3f",
    "businessId": "01936d2e-7a5b-7c8d-9e2f-3a4b5c6d7e8f",
    "userId": "01936d2e-6b4c-7d5e-8f9a-1b2c3d4e5f6a",
    "status": "pending",
    "currency": "USD",
    "total": 5998,
    "description": "Coffee Subscription - Premium Package",
    "customerEmail": "customer@example.com",
    "askShipping": true,
    "successUrl": "https://yoursite.com/success",
    "cancelUrl": "https://yoursite.com/cancel",
    "failureUrl": "https://yoursite.com/payment-failed",
    "checkoutUrl": "https://swiftpay.cx/checkout/01936d2e-8f4a-7b3c-9e5f-2a1c8d9b6e3f",
    "metadata": {
      "orderId": "ORD-2026-12345",
      "subscriptionId": "sub_premium_monthly",
      "customerTier": "gold",
      "isFirstOrder": true,
      "referralCode": "FRIEND20"
    },
    "items": [
      {
        "id": "01936d2e-9a8b-7c6d-5e4f-3a2b1c0d9e8f",
        "sessionId": "01936d2e-8f4a-7b3c-9e5f-2a1c8d9b6e3f",
        "name": "Premium Coffee Beans",
        "description": "Ethiopian Yirgacheffe - Light Roast",
        "price": 2499,
        "quantity": 2,
        "imageUrl": "https://yoursite.com/images/coffee.jpg",
        "subtotal": 4998
      },
      {
        "id": "01936d2e-9b7c-8d5e-6f4a-3b2c1d0e9f8a",
        "sessionId": "01936d2e-8f4a-7b3c-9e5f-2a1c8d9b6e3f",
        "name": "Shipping",
        "description": null,
        "price": 500,
        "quantity": 1,
        "imageUrl": null,
        "subtotal": 500
      }
    ],
    "createdAt": "2026-01-10T16:30:00.000Z",
    "updatedAt": "2026-01-10T16:30:00.000Z",
    "completedAt": null
  }
}

{
   "success": false,
   "error": {
      "type": "validation_error",
      "message": "Validation failed",
      "errors": [
         {
            "path": ["items", 0, "price"],
            "message": "Price must be between 0.01 and 999999.99"
         }
      ],
      "requestId": "req_01936d2e9c5b7d8e"
   }
}

{
   "success": false,
   "error": {
      "type": "validation_error",
      "message": "At least one item is required",
      "errors": [
         {
            "path": ["items"],
            "message": "At least one item is required"
         }
      ],
      "requestId": "req_01936d2e9d6c8e9f"
   }
}

{
   "success": false,
   "error": {
      "type": "validation_error",
      "message": "Too many metadata fields (max 50)",
      "errors": [
         {
            "path": ["metadata"],
            "message": "Too many metadata fields (max 50)"
         }
      ],
      "requestId": "req_01936d2e9e7d9f0a"
   }
}

{
   "success": false,
   "error": {
      "type": "authentication_error",
      "message": "Invalid API key",
      "requestId": "req_01936d2e9f8e0a1b"
   }
}