REST API Reference

Chipi's REST API lets you integrate StarkNet wallets and transfers from any programming language. No SDK required. Use standard HTTP requests with JSON payloads. All transactions are gasless. The API covers wallet creation, balance queries, token transfers, and digital service purchases.

All requests require a Bearer token:

bashcurl -H "Authorization: Bearer pk_prod_YOUR_KEY" \
  https://api.chipipay.com/v1/wallets

• - Base URL: https://api.chipipay.com/v1
• - Auth: Authorization: Bearer pk_prod_YOUR_KEY
• - Rate Limit: 100 requests/minute
• - Content-Type: application/json for POST requests

Get your API key from dashboard.chipipay.com.

Create Wallet:

bashcurl -X POST https://api.chipipay.com/v1/wallets \
  -H "Authorization: Bearer pk_prod_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"externalUserId":"user_123","chain":"STARKNET","walletType":"CHIPI","encryptKey":"..."}'

Get Wallet:

bashcurl "https://api.chipipay.com/v1/wallets?externalUserId=user_123" \
  -H "Authorization: Bearer pk_prod_YOUR_KEY"

Get Balance:

bashcurl "https://api.chipipay.com/v1/wallets/balance?walletPublicKey=0x...&chain=STARKNET&token=USDC" \
  -H "Authorization: Bearer pk_prod_YOUR_KEY"

Transfer Tokens:

bashcurl -X POST https://api.chipipay.com/v1/transfers \
  -H "Authorization: Bearer pk_prod_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"encryptKey":"...","walletPublicKey":"0x...","token":"USDC","recipient":"0x...","amount":"10","chain":"STARKNET"}'

Use human-readable amounts. The API handles decimal conversion. Supported tokens: USDC (6 decimals), ETH (18 decimals), STRK (18 decimals), or a full contract address for other ERC-20 tokens.

List SKUs (Mexico only):

bashcurl "https://api.chipipay.com/v1/skus?page=1&limit=12" \
  -H "Authorization: Bearer pk_prod_YOUR_KEY"

Purchase SKU:

bashcurl -X POST https://api.chipipay.com/v1/skus/purchase \
  -H "Authorization: Bearer pk_prod_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"encryptKey":"...","walletPublicKey":"0x...","skuId":"sku_123","reference":"5551234567","amount":"10"}'

14 categories available: telephony, electricity, internet, streaming, gift cards, gaming, transport, toll payments, TV, mobility, government, insurance, education, health.

• - Default to walletType: "CHIPI" for session key support
• - USDC has 6 decimals, ETH/STRK have 18 decimals
• - StarkNet addresses: 0x + 64 hex characters
• - All transactions are gasless. Users never pay gas fees
• - SKU marketplace is currently available in Mexico only
• - Webhook verification uses HMAC-SHA256 with your sk_prod_ secret key
• - API rate limit: 100 requests/minute
• - For server-side operations requiring the secret key, use the sk_prod_ key in the Authorization header