Connect Dodo Payments

Dodo Payments does not have a one-click connection, so you introduce the two systems by hand. Clakta gives you a web address, you paste it into Dodo, and Dodo starts sending your sales there.

It takes about five minutes and you only do it once.

Connect

In Clakta:

1. Open your project and go to Project settings → Sales platforms.
2. Find Dodo Payments and click Connect.
3. Give the connection a name you will recognise later, like Main account, then click Create connection.
4. Copy the Webhook URL that appears. Keep this window open.

In Dodo Payments:

5. Go to Developer → Webhooks → Add endpoint.

6. Paste the URL you copied.
7. Tick the payment, refund and dispute events (the full list is below), and save.

Ticking extra events does no harm — Clakta ignores anything it does not use.

8. Open the endpoint's Overview tab and copy the signing secret Dodo shows there — it starts with whsec_.

Back in Clakta:

9. Paste the signing secret and click Finish.

The card now says Added. New sales appear within a few seconds of being paid. Sales from before you connected are not imported.

Show product names and prices (optional)

By default Clakta records the money and the customer, but not what was bought: Dodo's messages carry product IDs, not names.

To fill that in, add an API key. In Dodo, go to Developer → API Keys, create one, and paste it into the API key (optional) field on the Clakta connection. Clakta then looks up the product names and prices for each sale.

Skip this and everything else still works — revenue, customer and source are all recorded either way.

Match sales to the visitors who made them

Recording a sale tells you that you earned money. Matching it to a visitor tells you where that money came from — which ad, which post, which page.

When your code creates the Dodo payment link or checkout, add a metadata field named clakta_session_id and put the visitor's Clakta session in it:

metadata: { clakta_session_id: claktaSessionId }

Read that value in the browser with clakta.getSessionId() and send it to your server along with the rest of the checkout request.

Test mode and live mode

Dodo keeps test and live separate, and so does Clakta. A webhook you create in test mode only ever receives test sales.

It is perfectly fine to have two connections — one for test, one for live. Give them names that tell them apart, because both will appear on the card.

What Clakta records

• How much the sale was for, in the currency it was paid in
• The customer's name, email, phone and city
• What they bought, if you added an API key
• How they paid — card, wallet, bank transfer, and so on
• Whether it was later refunded or charged back
• Which visitor and which ad it came from, when that is known

Refunds and disputes

Refund a payment in Dodo and the sale is marked refunded in Clakta. Refunding only part of it leaves the sale as paid, because Clakta records each sale as a single amount.

Chargebacks count once they are settled. Accept or lose one and the sale becomes refunded; win it and the sale goes back to paid.

Disconnect

Go to Project settings → Sales platforms, open the menu on the Dodo Payments card, and choose Delete. Dodo's messages stop being accepted immediately.

Delete the endpoint in Dodo too, so it stops trying to reach an address that no longer works.

Sales already recorded stay in Clakta. Disconnecting never deletes your history.

Common questions