⚡ HTTP REST API

KronoPay API Developer Documentation

KronoPay provides non-custodial crypto payment infrastructure with zero processing delays. All payments in USDT (TRC-20, BEP-20) or Binance Pay land directly in your private wallet with automated HMAC-SHA256 webhooks.

🔑 Authentication

Authenticate all API requests by supplying your Public API Key in the HTTP headers:

X-Api-Key: kp_live_pub_xxxxxxxxxxxxxxxxxxxx

# or

X-KronoPay-Public: kp_live_pub_xxxxxxxxxxxxxxxxxxxx

POST /api/v1/checkout/create

Creates an interactive checkout session and returns a hosted checkout URL for the customer.

Parameter	Type	Required	Description
amount	float / string	Yes	Base invoice amount in USD/USDT (e.g. 250.00)
order_id	string	Yes	Your unique internal order/invoice reference (e.g. ORD-9921)
customer_email	string (email)	Optional	Customer email address for receipts
return_url	string (URL)	Optional	Redirect target URL upon payment completion

Sample cURL Request:

curl -X POST https://kronopay.net/api/v1/checkout/create \ -H "Content-Type: application/json" \ -H "X-Api-Key: YOUR_PUBLIC_API_KEY" \ -d '{ "amount": 150.00, "order_id": "ORD-10928", "customer_email": "[email protected]", "return_url": "https://yourstore.com/checkout/complete" }'

📱 Binance C2C / Pay Flow

When a customer initiates a payment with network set to BINANCE_INTERNAL:

Your uploaded Binance Pay QR Code is presented to the customer.
Scanning the QR in the Binance app opens the transfer form directly.
The customer inputs the exact amount and unique payment note, which is instantly reconciled.

⚡ Verifying Webhook Signatures (HMAC-SHA256)

Every webhook event includes an X-KronoPay-Signature header generated with HMAC-SHA256 using your Secret Key.

🛡️

Cloudflare & WAF IP Whitelist Notice

For Instant Webhook / IPN Deliveries

Important: If your website is behind Cloudflare or a Web Application Firewall (WAF), whitelist our server IP address in your firewall to allow automated payment callbacks.

KronoPay Server Outbound IP: 76.13.8.203