Bill Payments — Node.js

import { ChipiServerSDK } from "@chipi-stack/backend";

const sdk = new ChipiServerSDK({
  apiPublicKey: process.env.CHIPI_PUBLIC_KEY!,
  apiSecretKey: process.env.CHIPI_SECRET_KEY!,
  baseUrl: process.env.CHIPI_BASE_URL, // omit for production
});

// Example: list Telcel phone-recharge options
const skus = await sdk.getSkuList({
  category: "RECARGAS",
  carrierName: "Telcel",
  limit: 20,
});

console.log(skus.length, "SKUs found");
console.log(skus[0]); // { id, chipiName, fixedAmount, currency, carrierName, ... }

import { Currency } from "@chipi-stack/backend"; // re-exported from @chipi-stack/types

const result = await sdk.purchaseSku({
  params: {
    skuId: chosenSku.id,                      // from getSkuList above
    skuReference: userPhoneNumber,            // user-facing reference (e.g. phone number)
    currencyAmount: chosenSku.fixedAmount,    // amount in the SKU's local currency (MXN)
    currency: Currency.MXN,
    chain: "STARKNET",
    token: "USDC",
    encryptKey: userPin,
    wallet: {
      publicKey: userWallet.publicKey,
      encryptedPrivateKey: userWallet.encryptedPrivateKey,
    },
  },
});

const purchaseId = result.id;
console.log("Purchase created:", purchaseId);

async function waitForSettlement(purchaseId: string) {
  for (let i = 0; i < 6; i++) {
    const purchase = await sdk.getSkuPurchase(purchaseId);
    if (purchase.status === "SUCCESS" || purchase.status === "FAILED") {
      return purchase;
    }
    await new Promise((r) => setTimeout(r, 2_500));
  }
  throw new Error("Settlement timeout — keep polling or use a webhook");
}

const final = await waitForSettlement(purchaseId);
console.log(final.status); // "SUCCESS" | "FAILED"

import { ChipiServerSDK, Currency } from "@chipi-stack/backend";

async function payTelcelRecharge(
  sdk: ChipiServerSDK,
  userPhone: string,
  userPin: string,
  userWallet: { publicKey: string; encryptedPrivateKey: string },
) {
  // 1. Find the right SKU — say, Telcel $200 prepaid
  const skus = await sdk.getSkuList({ category: "RECARGAS", carrierName: "Telcel" });
  const sku = skus.find((s) => s.fixedAmount === 200);
  if (!sku) throw new Error("SKU not found");

  // 2. Charge the user's wallet
  const { id: purchaseId } = await sdk.purchaseSku({
    params: {
      skuId: sku.id,
      skuReference: userPhone,
      currencyAmount: 200,
      currency: Currency.MXN,
      chain: "STARKNET",
      token: "USDC",
      encryptKey: userPin,
      wallet: userWallet,
    },
  });

  // 3. Wait for settlement
  for (let i = 0; i < 6; i++) {
    const p = await sdk.getSkuPurchase(purchaseId);
    if (p.status === "SUCCESS") return p;
    if (p.status === "FAILED") throw new Error("Purchase failed");
    await new Promise((r) => setTimeout(r, 2_500));
  }
  throw new Error("Settlement timeout — set up a webhook for production");
}