Skip to main content
GET
/
skus
curl -X GET "https://api.chipipay.com/v1/skus" \
  -H "Authorization: Bearer sk_prod_xxxx" \
  -H "Content-Type: application/json"

[
  {
    "id": "sku-tl-TEL010",
    "providerId": "telcel",
    "name": "Telcel 10 MXN",
    "description": "10 MXN credit for Telcel mobile service",
    "category": "TELEFONIA",
    "skuProvider": {
      "id": "telcel",
      "name": "Telcel",
      "logoUrl": "https://example.com/telcel-logo.png"
    },
    "referenceRegexValidation": "^[0-9]{10}$",
    "referenceLabel": "Phone Number",
    "amountRegexValidation": "^[0-9]+(\.[0-9]{1,2})?$",
    "amountLabel": "Amount (MXN)",
    "fixedAmount": 10,
    "canCheckSkuReference": true,
    "logoUrl": "https://example.com/sku-logo.png",
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:30:00Z"
  },
  {
    "id": "sku-tl-TEL020",
    "providerId": "telcel",
    "name": "Telcel 20 MXN",
    "description": "20 MXN credit for Telcel mobile service",
    "category": "TELEFONIA",
    "skuProvider": {
      "id": "telcel",
      "name": "Telcel",
      "logoUrl": "https://example.com/telcel-logo.png"
    },
    "referenceRegexValidation": "^[0-9]{10}$",
    "referenceLabel": "Phone Number",
    "amountRegexValidation": "^[0-9]+(\.[0-9]{1,2})?$",
    "amountLabel": "Amount (MXN)",
    "fixedAmount": 20,
    "canCheckSkuReference": true,
    "logoUrl": "https://example.com/sku-logo.png",
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:30:00Z"
  }
]

curl -X GET "https://api.chipipay.com/v1/skus" \
  -H "Authorization: Bearer sk_prod_xxxx" \
  -H "Content-Type: application/json"

[
  {
    "id": "sku-tl-TEL010",
    "providerId": "telcel",
    "name": "Telcel 10 MXN",
    "description": "10 MXN credit for Telcel mobile service",
    "category": "TELEFONIA",
    "skuProvider": {
      "id": "telcel",
      "name": "Telcel",
      "logoUrl": "https://example.com/telcel-logo.png"
    },
    "referenceRegexValidation": "^[0-9]{10}$",
    "referenceLabel": "Phone Number",
    "amountRegexValidation": "^[0-9]+(\.[0-9]{1,2})?$",
    "amountLabel": "Amount (MXN)",
    "fixedAmount": 10,
    "canCheckSkuReference": true,
    "logoUrl": "https://example.com/sku-logo.png",
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:30:00Z"
  },
  {
    "id": "sku-tl-TEL020",
    "providerId": "telcel",
    "name": "Telcel 20 MXN",
    "description": "20 MXN credit for Telcel mobile service",
    "category": "TELEFONIA",
    "skuProvider": {
      "id": "telcel",
      "name": "Telcel",
      "logoUrl": "https://example.com/telcel-logo.png"
    },
    "referenceRegexValidation": "^[0-9]{10}$",
    "referenceLabel": "Phone Number",
    "amountRegexValidation": "^[0-9]+(\.[0-9]{1,2})?$",
    "amountLabel": "Amount (MXN)",
    "fixedAmount": 20,
    "canCheckSkuReference": true,
    "logoUrl": "https://example.com/sku-logo.png",
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:30:00Z"
  }
]

​
Overview

Retrieve a list of all available services (SKUs) that can be purchased through the Chipi Pay API.

​
Endpoint

GET /skus

​
Headers

​
Authorization
string
required
Your secret key prefixed with “Bearer ”
​
Content-Type
string
application/json

​
Query Parameters

​
categories
array
Filter by service categories. Available categories:
  • TELEPEAJE - Toll payments
  • TELEFONIA - Phone services
  • GENERAL - General services
  • TESORERIA - Treasury services
  • LUZ - Electricity services
  • INTERNET - Internet services
  • TV - Television services
  • MOVILIDAD - Mobility services
  • RECARGAS - Recharge services
  • GIFT_CARDS - Gift cards
  • GAMING - Gaming services
  • VENTAS_CATALOGO - Catalog sales
  • DEPORTES - Sports services
  • STREAMING - Streaming services

​
Response Fields

​
id
string
Unique identifier for the SKU
​
providerId
string
Provider identifier
​
name
string
Display name of the service
​
description
string
Detailed description of the service
​
category
string
Service category (see available categories above)
​
skuProvider
object
Provider information object
​
skuProvider.id
string
Provider ID
​
skuProvider.name
string
Provider name
​
skuProvider.logoUrl
string
Provider logo URL
​
referenceRegexValidation
string
Regex pattern for validating reference input (e.g., phone number format)
​
referenceLabel
string
Label for the reference field (e.g., “Phone Number”, “Account Number”)
​
amountRegexValidation
string
Regex pattern for validating amount input
​
amountLabel
string
Label for the amount field (e.g., “Amount (MXN)”)
​
fixedAmount
number
Fixed amount for the service (if applicable, null for variable amounts)
​
canCheckSkuReference
boolean
Whether the SKU reference can be validated before purchase
​
logoUrl
string
URL to the service logo
​
createdAt
string
ISO 8601 timestamp of when the SKU was created
​
updatedAt
string
ISO 8601 timestamp of when the SKU was last updated

​
Example Usage

# Get all SKUs
curl -X GET "https://api.chipipay.com/v1/skus" \
  -H "Authorization: Bearer sk_prod_xxxx" \
  -H "Content-Type: application/json"

# Get only phone services
curl -X GET "https://api.chipipay.com/v1/skus?categories=TELEFONIA" \
  -H "Authorization: Bearer sk_prod_xxxx" \
  -H "Content-Type: application/json"

# Get multiple categories
curl -X GET "https://api.chipipay.com/v1/skus?categories=TELEFONIA&categories=INTERNET" \
  -H "Authorization: Bearer sk_prod_xxxx" \
  -H "Content-Type: application/json"

// Get all SKUs
const response = await fetch("https://api.chipipay.com/v1/skus", {
  method: "GET",
  headers: {
    "Authorization": `Bearer sk_prod_xxxx`,
    "Content-Type": "application/json"
  }
});

const skus = await response.json();
console.log(skus);

// Get only phone services
const phoneResponse = await fetch("https://api.chipipay.com/v1/skus?categories=TELEFONIA", {
  method: "GET",
  headers: {
    "Authorization": `Bearer sk_prod_xxxx`,
    "Content-Type": "application/json"
  }
});

const phoneSkus = await phoneResponse.json();
console.log(phoneSkus);

​
Error Responses

{
  "error": "unauthorized",
  "message": "Invalid or missing API key"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
categories
enum<string>[]

Filter by service categories

Available options:
TELEPEAJE,
TELEFONIA,
GENERAL,
TESORERIA,
LUZ,
INTERNET,
TV,
MOVILIDAD,
RECARGAS,
GIFT_CARDS,
GAMING,
VENTAS_CATALOGO,
DEPORTES,
STREAMING

Response

List of SKUs

​
id
string
required

Unique identifier for the SKU

​
providerId
string
required

Provider identifier

​
name
string
required

Display name of the service

​
category
enum<string>
required

Service category

Available options:
TELEPEAJE,
TELEFONIA,
GENERAL,
TESORERIA,
LUZ,
INTERNET,
TV,
MOVILIDAD,
RECARGAS,
GIFT_CARDS,
GAMING,
VENTAS_CATALOGO,
DEPORTES,
STREAMING
​
skuProvider
object
required

Provider information

​
referenceRegexValidation
string
required

Regex pattern for validating reference input

​
referenceLabel
string
required

Label for the reference field

​
amountRegexValidation
string
required

Regex pattern for validating amount input

​
amountLabel
string
required

Label for the amount field

​
canCheckSkuReference
boolean
required

Whether the SKU reference can be validated

​
description
string

Detailed description of the service

​
fixedAmount
number

Fixed amount for the service (if applicable)

​
logoUrl
string

URL to the service logo

​
createdAt
string<date-time>

ISO 8601 timestamp of when the SKU was created

​
updatedAt
string<date-time>

ISO 8601 timestamp of when the SKU was last updated