Skip to main content

Settlements API

Settlements = Completed Payments

In Lightning Enable, settlements are completed payments. The same API endpoints handle both. See the Payments API for the complete reference.

When a Lightning payment is confirmed, it becomes a settlement. Your payment provider (Strike or OpenNode) handles the settlement process automatically.

Key Endpoints​

All payment endpoints in the Payments API apply to settlements:

  • POST /api/payments — Create a payment (which settles automatically on confirmation)
  • GET /api/payments/{invoiceId} — Check payment/settlement status
  • POST /api/payments/{invoiceId}/sync — Force sync status from your payment provider

Settlement Webhooks​

You'll receive a webhook notification when a payment settles. There is no event envelope and no payment.completed event type — Lightning Enable forwards one flat JSON object per payment event and you route on its status field (treat status: "paid" as the settlement/fulfillment trigger). See Webhooks for the exact payload shapes and signature verification.