Skip to main content

API Reference

Base URL: https://api.ikawaari.com/v1

Authentication​

All requests require a Bearer token:

Authorization: Bearer ik_test_your_key_here

Request Format​

  • Content-Type: application/json
  • All amounts are in the smallest currency unit (e.g., 5000 = 5,000 XOF)
  • Dates are ISO 8601 or Unix timestamps

Response Format​

All responses return JSON. Successful responses include the resource object directly. Errors follow this format:

{
  "error": {
    "code": "error_code",
    "message": "Human-readable description",
    "type": "error_type"
  }
}

Pagination​

List endpoints support cursor-based pagination:

GET /v1/payment-intents?limit=10&starting_after=pi_abc123
ParameterDescription
limitNumber of items (1–100, default 10)
starting_afterCursor for next page
ending_beforeCursor for previous page

Idempotency​

For POST requests, include an Idempotency-Key header to safely retry requests:

curl -X POST https://api.ikawaari.com/v1/payment-intents \
  -H "Authorization: Bearer ik_test_your_key" \
  -H "Idempotency-Key: unique-request-id-123" \
  -H "Content-Type: application/json" \
  -d '{"amount": 5000, "currency": "XOF"}'

Resources​

Core​

Billing​

Connect​