Quickstart

node --version  # should be v18.0.0 or higher

pip install requests

const API_KEY = process.env.BAG_API_KEY!;
const BASE_URL = "https://www.getbags.app";

async function main() {
  const productRes = await fetch(`${BASE_URL}/api/v1/products`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": crypto.randomUUID(),
    },
    body: JSON.stringify({
      name: "Pro Plan",
      amount: 29.99,
      network: "base_sepolia",
    }),
  });
  const product = await productRes.json();
  if (product.status !== "success") throw new Error(product.message);

  const checkoutRes = await fetch(`${BASE_URL}/api/v1/checkouts`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": crypto.randomUUID(),
    },
    body: JSON.stringify({
      productId: product.data.id,
      network: "base_sepolia",
      externalCustomerId: "cus_123",
      metadata: { orderId: "ord_456" },
    }),
  });
  const checkout = await checkoutRes.json();
  if (checkout.status !== "success") throw new Error(checkout.message);

  console.log("Checkout ready:");
  console.log(`  Session: ${checkout.data.id}`);
  console.log(`  URL:     ${checkout.data.url}`);
}

main().catch(console.error);

import os
import uuid
import requests

API_KEY = os.environ["BAG_API_KEY"]
BASE_URL = "https://www.getbags.app"
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

product = requests.post(
    f"{BASE_URL}/api/v1/products",
    headers={**headers, "Idempotency-Key": str(uuid.uuid4())},
    json={"name": "Pro Plan", "amount": 29.99, "network": "base_sepolia"},
).json()
if product["status"] != "success":
    raise RuntimeError(product.get("message"))

checkout = requests.post(
    f"{BASE_URL}/api/v1/checkouts",
    headers={**headers, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "productId": product["data"]["id"],
        "network": "base_sepolia",
        "externalCustomerId": "cus_123",
        "metadata": {"orderId": "ord_456"},
    },
).json()
if checkout["status"] != "success":
    raise RuntimeError(checkout.get("message"))

print("Checkout ready:")
print(f"  Session: {checkout['data']['id']}")
print(f"  URL:     {checkout['data']['url']}")