Development Guide

Prerequisites: - Valid Kotani Pay integrator account - API credentials (JWT token and API key) - Development environment setup

Follow these guidelines for effective development with Kotani Pay API v3.

Set up your environment

Start with the sandbox environment for development and testing:

BASE_URL=https://sandbox-api.kotanipay.com

Authenticate your requests

Include your JWT token in the Authorization header:

curl -X GET "https://sandbox-api.kotanipay.com/health" \
  -H "Authorization: Bearer <your-jwt-token>" \
  -H "Content-Type: application/json"

Handle responses properly

All Kotani Pay API responses follow this structure:

{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    // Response data here
  }
}

Error Handling

Kotani Pay API uses standard HTTP status codes and consistent error format:

{
  "success": false,
  "message": "Error description",
  "data": {}
}

Common status codes:

Be mindful of API rate limits to ensure smooth integration:

Use our comprehensive test endpoints:

Verify API connectivity and service status

When ready to deploy: