NewCreate and share Pay LinksExplore Pay Links

FOR BUILDERS

USD invoices. Crypto pay-in.

  • · Create USD-denominated invoices via API
  • · Customers choose token and network at checkout
  • · Webhooks confirm payment in your systems

API base: https://api.meum.io/v1

Create an invoice

Authenticate with your API key and create a payment request. The response includes a checkout_url your customer can open to complete payment.

Request
POST /v1/invoices
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "external_order_id": "order-1048",
  "amount": "100.00",
  "currency": "USD",
  "return_url": "https://your-store.com/order/1048/complete"
}
Response
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "invoiceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "awaiting_payment",
  "checkout_url": "https://pay.meum.io/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "payment_url": "https://pay.meum.io/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "amount": "100.00",
  "currency": "USD",
  "output_asset": "nep141:sol-c800a4bd850783ccb82c2b2c7e84175443606352.omft.near",
  "expires_at": "2099-12-31T23:59:59.999Z"
}

Check payment status

Poll invoice status programmatically or wait for webhook events.

GET invoice status
GET /v1/invoices/{id}/status
Authorization: Bearer YOUR_API_KEY

Webhooks

Verify webhook signatures using the v1 HMAC scheme with your store webhook secret. Headers use X-Stablecoin-Signature with format v1=<hex>.

Refund-related event types exist in the schema, but merchant refund flows are not yet available.

invoice.createdinvoice.paidinvoice.failedinvoice.expiredinvoice.underpaidinvoice.cancelled
invoice.paid webhook
Content-Type: application/json
X-Stablecoin-Event: invoice.paid
X-Stablecoin-Event-Id: evt_abc123def456
X-Stablecoin-Timestamp: 1719234567
X-Stablecoin-Signature: v1=sha256_hmac_hex

{
  "id": "evt_abc123def456",
  "type": "invoice.paid",
  "createdAt": "2024-06-24T12:00:00.000Z",
  "organizationId": "org-uuid",
  "storeId": "store-uuid",
  "storePublicId": "northstar-goods",
  "data": {
    "invoice_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "external_order_id": "order-1048",
    "amount": "100.00",
    "currency": "USD",
    "status": "paid",
    "paid_at": "2024-06-24T12:05:00.000Z",
    "payment_url": "https://pay.meum.io/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}
Manage API keysConfigure webhooks