Developers
A small API for getting paid.
Create invoices from your own product, hand your customer a hosted payment URL, and reconcile statuses over plain JSON. No SDK required — just HTTPS and a Bearer token.

Quickstart
Your first invoice in one request.
Keys are created in your workspace under API keys. The full key is shown once; store it in your secrets manager.
- Base URLhttps://easyfy.casa/api/v1
- AuthenticationAuthorization: Bearer efy_live_…
- FormatJSON requests and responses, UTF-8, amounts in USD.
- AvailabilityAPI access is enabled once your account is approved.
# Check your available balance curl https://easyfy.casa/api/v1/balance \ -H "Authorization: Bearer $EASYFY_KEY" # { "object": "balance", "currency": "USD", # "available": 1250.00 }
Endpoints
Three endpoints cover the core flow.
| Method | Path | Purpose |
|---|---|---|
| GET | /api/v1/balance | Current available USD balance |
| GET | /api/v1/invoices | List your invoices with status and pay_url |
| POST | /api/v1/invoices | Create an invoice and receive its hosted pay_url |
Create an invoice
curl -X POST https://easyfy.casa/api/v1/invoices \
-H "Authorization: Bearer $EASYFY_KEY" \
-H "Content-Type: application/json" \
-d '{
"customer_name": "Acme Retail GmbH",
"customer_email": "[email protected]",
"amount": 480.00,
"description": "Wholesale order #1042",
"due_date": "2026-12-31"
}'
Response · 201 Created
{
"id": 42,
"number": "INV-2026-0042",
"amount": 480.0,
"currency": "USD",
"status": "open",
"pay_url": "https://easyfy.casa/pay/9f2c…"
}
Send pay_url to your customer. Poll GET /api/v1/invoices and watch the status field move from open → review → paid.
Integration notes
Built to be boring.
- Idempotent by invoice numberInvoice numbers are sequential per year and unique, so your reconciliation job always has a stable key.
- Explicit review stateA payment submitted by your customer appears as review until our team verifies it on-chain.
- No webhook dependencyWebhook delivery is not yet available; poll the invoice list on a schedule that suits your billing cycle.
- Keys can be revoked instantlyRotate or revoke a key from your workspace at any time. Revoked keys stop working immediately.
Need a deeper integration?
Tell us which system you bill from — a custom checkout, an ERP, or a marketplace — and we will help you map your flow onto invoices and pay URLs.
- Integration guidance by email
- Custom invoice metadata on request
- Volume fee schedules available