Connect Dodo Payments

You need a Dodo Payments account and a website in Revfaro with tracking installed. Open Website settings › Setup, go to Connect payments and choose the Dodo Payments tab: it shows these steps with your own webhook address.

These steps work with the script or npm SDK. With npm, initialize tracking on checkout and return pages, and use your shared tracker.attribution() instead of window.revfaro?.attribution?.() in browser examples. The SDK does not create a window global.

1. Add the webhook in Dodo Payments

   In Dodo Payments, go to Developer › Webhooks and add an endpoint with your website's address from the Dodo Payments tab:

   Copy

   https://revfaro.com/api/webhooks/dodo/YOUR_SITE_ID

   Subscribe it to payment.succeeded and refund.succeeded. Add it in live mode, so test payments don't count as revenue.

2. Paste the signing secret

   Copy the endpoint's signing secret (it starts with whsec_), paste it into Paste its signing secret and click Save. The tab shows Connected.

3. Pass the visitor to your checkout

   When your server creates a checkout session, add the visitor's cookies as metadata and set a return URL on your site:

   checkout.tsCopy

   const jar = await cookies(); // next/headers
   
   await dodo.checkoutSessions.create({
     // ...your existing options
     return_url: 'https://example.com/thanks',
     metadata: {
       rf_visitor_id: jar.get('rf_vid')?.value ?? '',
       rf_session_id: jar.get('rf_sid')?.value ?? '',
     },
   });

   Keep any metadata you already send and add these two keys.

Using payment links

Payment links need no code. The script adds metadata_rf_visitor_id and metadata_rf_session_id to every checkout.dodopayments.com link on your pages, including links added later by your own scripts.

Because that metadata doesn't always reach the payment, also give your payment links a return URL on your site (for example https://example.com/thanks). Dodo Payments adds ?payment_id=… to it, and Revfaro links the payment to the visitor who lands there. The return page must load the script and must not be excluded.

Redirecting to a payment link from JavaScript (window.location = …) instead of a normal link? Add the parameters yourself:

const { rf_visitor_id, rf_session_id } = window.revfaro?.attribution?.() ?? {};
const url = new URL('https://checkout.dodopayments.com/buy/pdt_xxx');
if (rf_visitor_id) {
  url.searchParams.set('metadata_rf_visitor_id', rf_visitor_id);
  url.searchParams.set('metadata_rf_session_id', rf_session_id);
}
window.location.href = url.toString();

One Dodo account, several websites

If you sell different products on different websites from one Dodo Payments account, each website's webhook receives every payment. Revfaro learns which product belongs to which website from checkout links and return pages, so most payments are placed automatically.

• To decide it yourself, open Selling other products from the same Dodo account? in the Dodo Payments tab, list the website's product IDs (such as pdt_abc123, pdt_def456) and click Save. Payments for those products count for this website. Renewals of a subscription already recorded here also count when Dodo omits its product list.
• Payments Revfaro can't place yet appear under Payments waiting for a site, with their product (or payment ID when Dodo supplies no product), count and amount. They are placed automatically once a buyer comes from one of your websites, or you can click Count for a website to assign them now.

What Revfaro records

• Payments from payment.succeeded, with the amount, currency and customer.
• Refunds from refund.succeeded, as negative amounts. A refund that arrives first waits for its payment. Refunds in the buyer's currency are scaled to the original payment's settlement amount.
• Currency: when Dodo Payments reports a settlement amount in your website's revenue currency, that amount is used. Other currencies stay in the payment history but are excluded from site totals.

Payments without a visitor ID are still matched when possible; see how payments are matched.

Dodo subscription payments can omit product_cart. Revfaro also checks product_id, a nested subscription product and earlier payments with the same subscription ID. If no site can be determined, assign the payment under Payments waiting for a site.

For older payments recorded without the original currency conversion details, resend the original payment.succeeded webhook from Dodo before a refund in another currency can be applied. Revfaro keeps that refund waiting instead of guessing an exchange rate.

Assigning pending payments to a website requires a workspace owner or admin. A website manager can configure its integration, but cannot resolve pending payment ownership across websites.