Skip to content
Thexly
Get started

Revenue attribution setup

Connect Yolfi for revenue attribution

Yolfi is a cryptocurrency payment processor (USDC, USDT, BTC, SOL, and others across several chains), not a card or bank processor. The connection is still just an API key, but a couple of things work differently.

Thexly doesn't do its own exchange-rate conversion for crypto payments. When a Yolfi payment was originally denominated in a real currency (e.g. a $20 checkout settled in USDC), Thexly records that original amount and currency. Otherwise, it uses the USD value Yolfi itself calculates and reports for the payment at the time it's recorded. Either way, the dollar figure in your dashboard comes from Yolfi's own data, not a separate lookup Thexly performs.

What you'll need

A Yolfi account with dashboard access.

Steps

  1. 1
    Open Yolfi and copy an organization API key.
  2. 2
    Paste it into Thexly under Settings → Payments → Yolfi. Thexly creates its own analytics webhook and stores its signing secret automatically. There's nothing else to configure.

What Thexly does with this connection

Thexly reads your completed payments (one-time and recurring) and matches them against sessions your tracking script captured, the same way it does for card and bank processors: by checkout session, customer identifier, or the session id attached to the payment's metadata. See how Thexly assigns revenue to a channel for the full mechanism.

Yolfi checkouts aren't auto-decorated by Thexly's tracking script, so if you build your own checkout flow, pass the visitor's session in metadata as thexly_session_id. Call window.thexly.getSessionId() from your checkout page to get it.

For recurring crypto payments, Thexly also tracks subscription state from Yolfi's webhook: a subscription moves to past-due if a renewal payment is overdue, and to canceled once it's stopped. That status is visible in Revenue Diagnostics, alongside every other processor's subscriptions.

Troubleshooting

  • Key rejected on save: make sure you copied an organization-level key from Yolfi's dashboard, not a personal or wallet-specific credential.
  • Payments not appearing after connecting: check Settings → Payments for a "needs review" status on the Yolfi connection; a rejected webhook registration shows there rather than failing silently.

What's next

Verify it's working.

← Back to Docs