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 result = await sdk.getSkuList({
  chipiCategory: "RECARGAS",
  carrierName: "Telcel",
  limit: 20,
});

console.log(result.total, "matching SKUs");
console.log(result.data[0]); // { id, name, chipiName, fixedAmount, currency, carrierName, ... }

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

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
    currency: Currency.MXN,
    chain: Chain.STARKNET,
    token: ChainToken.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,
  Chain,
  ChainToken,
  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 list = await sdk.getSkuList({
    chipiCategory: "RECARGAS",
    carrierName: "Telcel",
    limit: 50,
  });
  const sku = list.data.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: Chain.STARKNET,
      token: ChainToken.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");
}