Skip to main content

​
Prerequisites

  • Settlement wallet configured
  • Store-scoped API key with invoices:create scope

​
Steps

  1. Create an invoice:
curl -X POST https://api.meum.io/v1/invoices \
  -H "Authorization: Bearer sk_live_EXAMPLE_DO_NOT_USE" \
  -H "Content-Type: application/json" \
  -d '{
    "external_order_id": "demo_order_001",
    "amount": "10.00",
    "currency": "USD",
    "return_url": "https://example.com/thank-you"
  }'
  1. Open the checkout_url from the response (e.g. https://pay.meum.io/{invoiceId})
  2. Select a payment token and enter a refund address
  3. Complete the on-chain payment (or use dev simulation if available in your environment)
  4. Poll status or wait for webhook:
curl https://api.meum.io/v1/invoices/{invoiceId}/status \
  -H "Authorization: Bearer sk_live_EXAMPLE_DO_NOT_USE"

​
Expected result

Invoice status transitions to paid. Webhook invoice.paid is delivered if configured.