Skip to main content
GET
/
skus
/
{id}
curl -X GET "https://api.chipipay.com/v1/skus/sku-tl-TEL010" \
  -H "Authorization: Bearer sk_prod_xxxx" \
  -H "x-api-key: pk_xxxx"

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

curl -X GET "https://api.chipipay.com/v1/skus/sku-tl-TEL010" \
  -H "Authorization: Bearer sk_prod_xxxx" \
  -H "x-api-key: pk_xxxx"

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

Authorizations

​
Authorization
string
header
required

Bearer token — use your secret key (sk_prod_xxx) for server-side calls, or the user's JWT for client-side calls

​
x-api-key
string
header
required

Your Chipi public API key (pk_xxx)

Path Parameters

​
id
string
required

The SKU identifier

Response

SKU details

​
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 for SKUs

Available options:
TELEPEAJE,
TELEFONICA,
GENERAL,
TESORERIA,
LUZ,
INTERNET,
TV,
MOVILIDAD,
RECARGAS,
GIFT_CARDS,
GAMING,
VENTAS_CATALOGO,
DEPORTES,
STREAMING
​
referenceRegexValidation
string
required

Regex pattern for validating reference input (e.g., phone number format)

​
referenceLabel
string
required

Label for the reference field (e.g., "Phone Number")

​
amountRegexValidation
string
required

Regex pattern for validating amount input

​
amountLabel
string
required

Label for the amount field

​
currency
enum<string>
required

Fiat currency code

Available options:
MXN,
USD
​
canCheckSkuReference
boolean
required

Whether the reference can be validated before purchase

​
description
string

Detailed description of the service

​
fixedAmount
number

Fixed amount for the service (omitted for variable amounts)

​
logoUrl
string

URL to the service logo

​
createdAt
string<date-time>
​
updatedAt
string<date-time>