POST
/
sku-transactions
curl -X POST "https://api.chipipay.com/v1/sku-transactions" \
  -H "Authorization: Bearer sk_prod_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "skuId": "sku-tl-TEL010",
    "chain": "BASE",
    "chainToken": "ETH",
    "mxnAmount": 10,
    "reference": "7773271789",
    "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
  }'

{
  "id": "tx_1234567890abcdef",
  "orgId": "org_1234567890abcdef",
  "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "skuId": "sku-tl-TEL010",
  "mxnAmount": 10,
  "usdAmount": 0.59,
  "reference": "7773271789",
  "fileNumber": null,
  "status": "pending",
  "chain": "BASE",
  "chainToken": "ETH",
  "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "errorMessage": null,
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

curl -X POST "https://api.chipipay.com/v1/sku-transactions" \
  -H "Authorization: Bearer sk_prod_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "skuId": "sku-tl-TEL010",
    "chain": "BASE",
    "chainToken": "ETH",
    "mxnAmount": 10,
    "reference": "7773271789",
    "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
  }'

{
  "id": "tx_1234567890abcdef",
  "orgId": "org_1234567890abcdef",
  "walletAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "skuId": "sku-tl-TEL010",
  "mxnAmount": 10,
  "usdAmount": 0.59,
  "reference": "7773271789",
  "fileNumber": null,
  "status": "pending",
  "chain": "BASE",
  "chainToken": "ETH",
  "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "errorMessage": null,
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

​
Overview

Purchase a service using a blockchain transaction. Before calling this endpoint, you must first process a payment using the Chipi Pay smart contract and provide the transaction hash.

​
Endpoint

POST /sku-transactions

​
Headers

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

​
Request Body

​
walletAddress
string
required
The wallet address that made the payment transaction
​
skuId
string
required
The SKU ID of the service you want to purchase (obtained from GET /skus)
​
chain
string
required
The blockchain network ID. Supported values: “STARKNET”, “BASE”, “ARBITRUM”, “OPTIMISM”, “ROOTSTOCK”, “SCROLL”
​
chainToken
string
required
The token used for payment. Supported values: “USDC”, “ETH”, “STRK”, “SLINK”, “ALF”, “BROTHER”, “ARB”, “DOC”
​
mxnAmount
number
required
The amount in MXN (Mexican Pesos) for the service
​
reference
string
required
A unique reference number for this transaction (e.g., phone number, account number)
​
transactionHash
string
required
The transaction hash from the blockchain payment

​
Response Fields

​
id
string
Unique identifier for this transaction
​
orgId
string
Organization ID that created the transaction
​
walletAddress
string
The wallet address that made the payment
​
skuId
string
The SKU ID of the purchased service
​
mxnAmount
number
The amount in MXN
​
usdAmount
number
The amount in USD (calculated from MXN)
​
reference
string
The reference number provided
​
fileNumber
string
File number for the transaction (if applicable, null otherwise)
​
status
string
Current status of the transaction (“pending”, “processing”, “completed”, “failed”)
​
chain
string
The blockchain network used
​
chainToken
string
The token used for payment
​
transactionHash
string
The blockchain transaction hash
​
errorMessage
string
Error message if the transaction failed (null if successful)
​
createdAt
string
ISO 8601 timestamp of when the transaction was created
​
updatedAt
string
ISO 8601 timestamp of when the transaction was last updated

​
Webhook Notifications

Once the transaction is submitted, you’ll receive status updates via webhooks at the URL you configured in your dashboard. The webhook payload will include the transaction status and any additional details about the service delivery.

​
Error Responses

{
  "error": "invalid_request",
  "message": "Missing required field: skuId"
}

​
Smart Contract Integration

Before calling this endpoint, you must process the payment using the Chipi Pay smart contract: The transaction hash from the smart contract payment is required to complete the service purchase.

​
Supported Chains and Tokens

Chains:
  • STARKNET
  • BASE
  • ARBITRUM
  • OPTIMISM
  • ROOTSTOCK
  • SCROLL
Tokens:
  • USDC
  • ETH
  • STRK
  • SLINK
  • ALF
  • BROTHER
  • ARB
  • DOC

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Service purchase request

The body is of type object.

Response

200
application/json

Transaction created

The response is of type object.