Skip to main content

​
Base URL

https://api.chipipay.com/v1

​
Authentication

All API requests require authentication using your Secret Key (sk_prod_xxxx). Include it in the Authorization header: 
Authorization: Bearer sk_prod_xxxx
For detailed instructions on obtaining your API key, see the API Quickstart.

​
Overview

The Chipi Pay API provides endpoints for:
  • Getting Available Services – Retrieve a list of services (SKUs) available for purchase.
  • Buying Services – Process service purchases using blockchain transactions.

​
Notifications and Webhooks

When you buy a service, you’ll receive status updates via webhooks or email at the URL and email address you configured in your dashboard.

​
Steps to set up your webhook

  • For setting up webhooks and email notifications, see the API Quickstart.

​
Rate Limits

API requests are limited to 100 requests per minute per API key.

​
Error Handling

The API uses standard HTTP status codes to indicate success or failure:
  • 200 - Success
  • 400 - Bad Request
  • 401 - Unauthorized
  • 404 - Not Found
  • 429 - Rate Limited
  • 500 - Internal Server Error
Error responses include a JSON object with an error and message field: 
{
  "error": "invalid_request",
  "message": "The request was invalid"
}