Bill Payments

​

At a glance

​

What’s in the catalog

• 📱 Phone Recharges
• 🎁 Gift Cards
• 🧾 Bills & Services
• 📞 Phone Bundles

35 carriers · 379 servicesTop up prepaid phone balance for any major Mexican carrier. Your users pay in USDC, the carrier sees a normal recharge.

Telcel

AT&T

Movistar

BAIT

Mimovil

ULTRACEL

Axios Mobile

VALOR TELECOM

…and 27 more carriers (FlashMobile, OUI, RediCoppel, FRC Mobile, ABIB, Beneleit, Megamovil, and others).

See the integration code (Telcel example)

curl -G "https://api.chipipay.com/v1/skus" \
  --data-urlencode "chipiCategory=RECARGAS" \
  --data-urlencode "carrierName=Telcel" \
  --data-urlencode "limit=20" \
  -H "x-api-key: $CHIPI_PUBLIC_KEY" \
  -H "Authorization: Bearer $CHIPI_CUSTOMER_JWT"

Response is a paginated { data, total, page, limit, totalPages } where each entry in data is an SKU ({ id, name, chipiName, fixedAmount, currency, carrierName, ... }). Pass an id to POST /v1/sku-purchases to charge — see the Node guide.

41 brands · 142 servicesSell digital gift cards funded with crypto. Codes are delivered instantly after settlement.

Amazon

Cinepolis

Nintendo

Netflix

Google Play

Free Fire

Cinemex

Gandhi

…and 33 more brands (Innvictus, PUBG Mobile, Amazon Prime Video, and others).

See the integration code (Amazon example)

curl -G "https://api.chipipay.com/v1/skus" \
  --data-urlencode "chipiCategory=GIFT_CARDS" \
  --data-urlencode "carrierName=Amazon Gift Card" \
  -H "x-api-key: $CHIPI_PUBLIC_KEY" \
  -H "Authorization: Bearer $CHIPI_CUSTOMER_JWT"

88 providers · 141 servicesUtility bills, toll roads, government services, cable / streaming subscriptions, beauty brand orders.

CFE

Telmex

Megacable

Dish

Infonavit

Televia

IAVE

Pase Urbano

…plus water utilities (28 cities), state government services, and 60+ other providers.

See the integration code (CFE example)

curl -G "https://api.chipipay.com/v1/skus" \
  --data-urlencode "chipiCategory=GENERAL" \
  --data-urlencode "carrierName=CFE" \
  -H "x-api-key: $CHIPI_PUBLIC_KEY" \
  -H "Authorization: Bearer $CHIPI_CUSTOMER_JWT"

7 carriers · 48 servicesPostpaid plans, internet packages, and combo bundles.

Telcel Internet Amigo

Paquetes BAIT

Paquete Amigo Sin Limite

WimoTelecom Internet

​

Prerequisites

1. A Chipi org with an API key. Get yours from dashboard.chipipay.com → API Keys. Use pk_dev_... while integrating (sandboxed, see below) and pk_prod_... for live traffic.
2. A pre-funded credits balance. Deposit USDC to your org’s Chipi credits address (visible in the dashboard’s Billing tab). Each PROD purchase debits this balance, not an end-user wallet. DEV purchases never touch it.
3. A JWKS rule registered for your API key. Every endpoint on this page (catalog reads, purchase POST, status polling) is guarded by Chipi’s BearerTokenGuard and requires both an x-api-key header and a customer JWT in the Authorization: Bearer header. The JWT is issued by your auth provider; Chipi validates it against the JWKS URL you register (typically your auth provider’s .well-known/jwks.json, e.g. https://clerk.yourdomain.com/.well-known/jwks.json).

​

How it works

1. Browse the catalog with GET /v1/skus — filter by category + carrierName to find what you need.
2. Buy with POST /v1/sku-purchases — pass skuId, skuReference (phone number, account, etc.), currencyAmount, and any non-empty string as transactionHash (it’s used as the idempotency key, not as an on-chain hash). Chipi debits your credits balance, returns a PENDING transaction immediately.
3. Track with GET /v1/sku-purchases/:id — poll until status is SUCCESS or FAILED. Most settle in under 5 seconds.

​

DEV sandbox

​

What you charge your users

✅ Verified against the live API on 2026-05-19 with a real production purchase: Virgin $20 MXN recharge to a live phone, settled SUCCESS with TET file number returned in under 5 seconds.