Wownero checkout documentation & API reference.

Start here

1. 1) Sign in (view-only)

   Use your primary address + secret view key to retrieve an API key.

2. 2) Create an invoice

   Call POST /api/core/invoices and redirect the customer to the hosted invoice URL.

3. 3) Optional: configure webhooks

   Subscribe to invoice.confirmed to get status events pushed to your system.

4. 4) Confirm and fulfill

   Wait for invoice.confirmed (webhook or polling). You can also check the public status endpoint, then mark your order paid.

Fiat inputs (optional)

You can request an invoice using a fiat amount. The backend converts the value to WOW using the current rate and returns a non-binding quote in the response. The invoice is always stored in WOW.

POST /api/core/invoices
Authorization: ApiKey <api_key>
Content-Type: application/json

{
  "amount_fiat": "100.00",
  "currency": "USD",
  "confirmation_target": 2,
  "checkout_continue_url": "https://merchant.example/thanks",
  "metadata": { "order_id": "ORDER-1234" }
}