curl -X POST "https://api.chipipay.com/v1/sku-transactions" \ -H "Authorization: Bearer sk_prod_xxxx" \ -H "Content-Type: application/json" \ -d '{ "walletAddress": "0x049d36570d4e46f48e99674bd3fcc84644ddgruheumskde", "skuId": "test_10", "chain": "STARKNET", "chainToken": "ETH", "mxnAmount": 250.00, "reference": "TET_PURCHASE_20241201", "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890lwijeqijepqeqqaedef" }'
200 Response
400 Bad Request
400 Bad Request
400 Bad Request
401 Unauthorized
429 Too Many Requests
{ "id" : "sku-tx-b43ea3b1-3366-4ecb-9006-bb73b55767dc" , "orgId" : "org_31921AlOILtmngHwdqKOYRgYgfe" , "walletAddress" : "0x049d36570d4e46f48e9Sasjkidd6b96f7c741b1562b82f9e004dc7" , "skuId" : "test_100" , "mxnAmount" : 250 , "usdAmount" : 13.4202222 , "reference" : "TET_PURCHASE_20241201" , "fileNumber" : null , "status" : "PENDING" , "chain" : "STARKNET" , "chainToken" : "ETH" , "transactionHash" : "0x1234567890abcdef1234567aka34567890abcdef1234567890abcdef" , "createdAt" : "2025-08-14T00:05:06.602Z" , "updatedAt" : "2025-08-14T00:05:06.602Z" , "errorMessage" : null }
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 Your secret key prefixed with “Bearer ”
Request Body The wallet address that made the payment transaction
The SKU ID of the service you want to purchase (obtained from GET /skus)
The blockchain network ID. Supported values: “STARKNET”, “BASE”, “ARBITRUM”, “OPTIMISM”, “ROOTSTOCK”, “SCROLL”
The token used for payment. Supported values: “USDC”, “ETH”, “STRK”, “SLINK”, “ALF”, “BROTHER”, “ARB”, “DOC”
The amount in MXN (Mexican Pesos) for the service
A unique reference number for this transaction (e.g., phone number, account number)
The transaction hash from the blockchain payment
Response Fields Unique identifier for this transaction
Organization ID that created the transaction
The wallet address that made the payment
The SKU ID of the purchased service
The amount in USD (calculated from MXN)
The reference number provided
File number for the transaction (if applicable, null otherwise)
Current status of the transaction (“pending”, “processing”, “completed”, “failed”)
The blockchain network used
The token used for payment
The blockchain transaction hash
Error message if the transaction failed (null if successful)
ISO 8601 timestamp of when the transaction was created
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 400 Bad Request
400 Bad Request
400 Bad Request
401 Unauthorized
429 Too Many Requests
{ "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
Bearer authentication header of the form Bearer <token> <token>
The wallet address that made the payment transaction
The SKU ID of the service you want to purchase
The blockchain network ID
Available options:
STARKNET,
BASE,
ARBITRUM,
OPTIMISM,
ROOTSTOCK,
SCROLL
The token used for payment
Available options:
USDC,
ETH,
STRK,
SLINK,
ALF,
BROTHER,
ARB,
DOC
The amount in MXN (Mexican Pesos) for the service
A unique reference number for this transaction (e.g., phone number, account number)
The transaction hash from the blockchain payment
Unique identifier for this transaction
Organization ID that created the transaction
The wallet address that made the payment
The SKU ID of the purchased service
The reference number provided
Current status of the transaction
Available options:
pending,
processing,
completed,
failed
The blockchain network used
Available options:
STARKNET,
BASE,
ARBITRUM,
OPTIMISM,
ROOTSTOCK,
SCROLL
The token used for payment
Available options:
USDC,
ETH,
STRK,
SLINK,
ALF,
BROTHER,
ARB,
DOC
The blockchain transaction hash
createdAt
string<date-time>
required
ISO 8601 timestamp of when the transaction was created
updatedAt
string<date-time>
required
ISO 8601 timestamp of when the transaction was last updated
File number for the transaction (if applicable)
Error message if the transaction failed
