Inkress SDK Integration Guide

import InkressSDK from "@inkress/admin-sdk";

const INKRESS_CONFIG = {
  accessToken: process.env.INKRESS_API_KEY,
  mode: process.env.NODE_ENV === 'production' ? 'live' : 'sandbox',
  platformMerchantId: 'your-platform-username',
};

/**
 * Creates an SDK instance.
 * @param merchantUsername - (Optional) If provided, scopes actions to this sub-merchant.
 */
export async function createInkressSDK(merchantUsername?: string) {
  return new InkressSDK({
    accessToken: INKRESS_CONFIG.accessToken,
    mode: INKRESS_CONFIG.mode,
    username: merchantUsername, 
  });
}

async function onboardMerchant(merchantInfo) {
  const platformSdk = await createInkressSDK(); // No username = Platform Context

  const merchant = await platformSdk.merchants.create({
    name: merchantInfo.business_name,
    email: merchantInfo.email,
    username: merchantInfo.unique_slug,
    business_type: 'service',
    webhook_url: 'https://your-platform.com/api/webhooks/inkress',
    data: {
      internal_id: merchantInfo.id
    }
  });

  return { inkressId: merchant.id, inkressUsername: merchant.username };
}

async function subscribeMerchant(merchantUsername, planUid, merchantDetails) {
  const merchantSdk = await createInkressSDK(merchantUsername);

  // Create a subscription link
  const result = await merchantSdk.subscriptions.createLink({
    title: 'Platform Subscription',
    plan_uid: planUid, // Use the UID string, e.g., "plan_abc123"
    customer: {
      first_name: merchantDetails.firstName,
      last_name: merchantDetails.lastName,
      email: merchantDetails.email
    },
    meta_data: {
    return_url: 'https://your-platform.com/dashboard/plans',
      internal_merchant_id: merchantDetails.id
    },
    reference_id: `sub_${merchantDetails.id}_${Date.now()}`
  });

  return result.payment_urls.short_link;
}

async function syncProduct(merchantUsername, serviceItem) {
  const merchantSdk = await createInkressSDK(merchantUsername);

  const product = await merchantSdk.products.create({
    title: serviceItem.name,
    price: serviceItem.price,
    currency_code: 'JMD',
    permalink: `item-${serviceItem.id}`,
    public: false,
    unlimited: true // useful for services
  });

  return product.id;
}

async function createTransaction(merchantUsername, orderDetails) {
  const merchantSdk = await createInkressSDK(merchantUsername);
  
  // 1. Resolve Product ID
  let productId = orderDetails.item.inkress_product_id;

  // 2. Create Order
  const order = await merchantSdk.orders.create({
    customer: {
      email: orderDetails.customer.email,
      first_name: orderDetails.customer.firstName,
      last_name: orderDetails.customer.lastName
    },
    currency_code: 'JMD',
    products: [{
      id: productId,
      quantity: 1,
    }],
    kind: 'online',
    meta_data: {
        return_url: 'https://your-platform.com/checkout/complete',
    },
  });

  return order.payment_urls.short_link;
}

export async function webhookHandler(request) {
  const payload = await request.json();
  const { event, data } = payload;

  switch (event) {
    case 'orders.paid':
      if (data.order.reference) {
        await updateTransactionStatus(data.order.reference, 'paid');
      }
      break;

    case 'subscriptions.activated':
      await updateMerchantAccess(data.customer.email, 'active');
      break;
  }
  
  return { received: true };
}