Quickstart

Your first successful API call, start to finish, in about a minute. No signup, no card — everything below runs against your own test sandbox.

Your test keysk_test_…

1 · Create an invoice

An invoice bundles line items for a customer and returns a hosted, payable page. Press Run — the real JSON response renders right here, and an invoice.created event lands in your dashboard.

POST/v1/invoices

Auth is basic-auth with your secret key as the username. Amounts are in the smallest currency unit — 3600 is $36.00.

cURLNodePython

2 · Open the hosted invoice

The response includes a hosted_invoice_url. Click Open hosted page ↗ after running the call above. You'll see a branded invoice you can pay with a test card.

💳

Pay with 4242 4242 4242 4242, any future expiry, any CVC. Want to see a decline? Try 4000 0000 0000 9995 (insufficient funds). Full list on the testing page.

3 · Watch the events

Every state change emits an immutable event. List the last ten — you'll see the invoice you just created (and, once you pay it, invoice.paid).

GET/v1/events

The same stream powers the live feed in your Workbench. Open it in another tab and run the call above — watch the row slide in.

cURLNodePython

You're integrated

That's the whole loop: create → hosted page → event. Everything else is more of the same shape.