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

Response

200
application/json

List of SKUs

The response is of type object[].