EasilyPay API Reference

Build secure crypto payment experiences using the EasilyPay Merchant API. Simple integration, automatic webhooks, real-time invoice tracking.

Authentication

All requests must include API credentials via HTTP headers. You can find these inside your Merchant Dashboard.

Header Description
X-API-KEY Public API key (starts with ep_)
X-API-SECRET Private secret key (never expose client-side)
X-WEBSITE-DOMAIN Registered website host (example: domain.com)

Website Domain Rule

Important:

  • Send only the domain host.
  • Do NOT include https://
  • Do NOT include trailing slash.
  • www is automatically normalized.
✅ domain.com
❌ https://domain.com
❌ https://www.domain.com/

Base URL

https://easilypay.co.uk/api/v1
POST

/invoices

Creates a payment invoice and generates a unique LTC address.

curl -X POST https://easilypay.co.uk/api/v1/invoices \
-H "X-API-KEY: your_api_key" \
-H "X-API-SECRET: your_api_secret" \
-H "X-WEBSITE-DOMAIN: domain.com" \
-H "Content-Type: application/json" \
-d '{
 "amount":25.00,
 "currency":"USD",
 "order_id":"ORD-123",
 "customer_email":"[email protected]"
}'
GET

/invoices/{invoice_id}

{ "ok": true, "invoice_id": "INV-XXXX", "amount_usd": 50, "status": "confirmed", "confirmations": 3 }

Webhook Events

When a payment is confirmed, EasilyPay automatically sends a POST request to your webhook URL.

POST https://yourdomain.com/ipn/easilypay { "event":"invoice.confirmed", "data":{ "invoice_id":"INV-XXXX", "order_id":"ORD-123", "status":"confirmed", "amount_usd":25.00, "amount_ltc":0.32 } }

API Sandbox