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.

Developer workspace

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.

MethodPathPurpose
GET/api/v1/balanceCurrent available USD balance
GET/api/v1/invoicesList your invoices with status and pay_url
POST/api/v1/invoicesCreate 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.