Introduction

1. Create a product (dashboard or API)
2. Initiate a payment → receive a paymentUrl
3. Redirect your customer to the paymentUrl
4. Receive webhooks as the payment progresses
5. Grant access based on webhook events

interface WebhookEvent {
  id: string;                    // Unique event ID (evt_xxx)
  type: string;                  // CHECKOUT_INITIATED, CHECKOUT_SUCCESS, TX_SUCCESS, PAYMENT_SUCCESS, PAYMENT_FAILED, PAYMENT_REFUNDED
  createdAt: string;             // ISO 8601 timestamp
  data: {
    payment: {
      id: string;                // Payment ID
      status: string;            // Current payment status
      subscriptionId: string | null;
      productId: string | null;
      valueUsd: string | null;   // Amount in cents
      txHash: string | null;     // Blockchain transaction hash (crypto only, null for card)
      source: string | null;     // "CRYPTO" or "FIAT"

      // Customer identification
      customerEmail: string | null;
      customerDiscordId: string | null;
      customerTelegramId: string | null;
      customerDiscordUsername: string | null;
      customerTelegramUsername: string | null;
    };
    context: {
      externalRef: string | null;       // Your internal reference
      metadata: Record<string, any> | null;  // Custom metadata you passed at payment creation
      successUrl: string | null;
      cancelUrl: string | null;
    };
  };
}

const signedPayload = `${timestamp}.${rawBody}`;
const expected = crypto
  .createHmac("sha256", webhookSecret)
  .update(signedPayload)
  .digest("hex");

const isValid = signature === `v1=${expected}`;

# 1. Create a product
curl -X POST https://api.suby.fi/api/product/create \
  -H "Content-Type: application/json" \
  -H "X-Suby-Api-Key: sk_live_your_key" \
  -d '{
    "name": "Pro Plan",
    "priceCents": "999",
    "currency": "EUR",
    "frequencyInDays": 30,
    "platform": "WEB",
    "paymentMethods": ["CARD", "CRYPTO"],
    "acceptedChains": [8453, 42161]
  }'

# 2. Create a payment intent
curl -X POST https://api.suby.fi/api/payment/initiate \
  -H "Content-Type: application/json" \
  -H "X-Suby-Api-Key: sk_live_your_key" \
  -d '{
    "planId": "your_product_id",
    "customerEmail": "customer@example.com",
    "externalRef": "order_123",
    "metadata": { "userId": "usr_456" },
    "successUrl": "https://your-app.com/success",
    "cancelUrl": "https://your-app.com/cancel"
  }'

# Response:
# {
#   "success": true,
#   "data": {
#     "paymentId": "pay_abc123",
#     "paymentUrl": "https://app.suby.fi/pay/pay_abc123"
#   }
# }

# 3. Redirect customer to paymentUrl
# 4. Receive webhooks → grant access