Skip to main content

When it fires

After Settlx successfully transfers the settled funds to your configured wallet address. At this point the payment lifecycle is complete and the money is yours.

What to do

Fulfill the order. This is the only event that confirms funds have arrived in your wallet.
  • Release the digital product
  • Activate the subscription
  • Ship the physical order
  • Grant account access
Do not fulfill on any earlier event such as invoice.confirmed. Payment confirmation does not mean settlement is complete.

What lands in your wallet

The amount that arrives in your wallet is data.settlement.netAmount — the gross amount minus all fees.

Payload

Includes: invoice, payment, settlement, fees. Also includes conversion if a token swap occurred.

Handler example

Node.js
Always use data.invoice.metadata.orderId to identify the order. Never rely on data.invoice.id alone as your order identifier — invoice IDs are internal to Settlx and not meaningful to your system without the metadata link.