Quickstart

Create an App

In the dashboard, create an App for your business and add at least one Route — the channel that holds your webhook URL (where we notify you) and return URL (where customers land after paying). Enable the payment methods you want to offer under Settings → Payment Methods.

Get Your API Key

Each route has its own API key. You send it as the x-api-key header on every request. Keep it server-side — never expose it in client code.

Initialize a Payment

Send the order to POST /api/init-payment. The response contains a hosted checkout url.

curl -X POST https://pay.iconeht.com/api/init-payment \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "action": "purchase",
    "referenceId": "order_1024",
    "currency": "htg",
    "amount": 2500,
    "items": [
      { "name": "T-shirt", "quantity": 1, "unitPrice": 2500, "currency": "htg" }
    ],
    "successUrl": "https://yourstore.com/thanks",
    "cancelUrl": "https://yourstore.com/cart"
  }'

Redirect and Confirm

Redirect the customer to url. When they finish, we POST a signed webhook to your route's webhook URL and send the customer to your successUrl. Verify the signature (see Verifying Webhooks) and mark the order paid.