Wat u nodig hebt
| Veld | Wat het doet |
|---|---|
| API key | Laat ons Dodo aanroepen om de gehoste checkout aan te maken. Geheim. |
| Webhook signing secret (whsec_…) | Bevestigt dat een webhook echt van Dodo kwam. Geheim. |
| Return-URL | Waar de koper belandt na de checkout. |
Waarom we om elk veld vragen
API key
Autoriseert het aanmaken van de gehoste checkout, zodat de afschrijving via uw account loopt.
Webhook signing secret
Bewijst dat een inkomende webhook echt van Dodo is, zodat niemand een "betaald"-event kan vervalsen. Het is een aparte waarde van de API key.
Return-URL
Gewone instelling: waar de koper belandt na de checkout. Niet geheim.
Instellen
- Gebruik testmodus (gratis)
Dodo heeft een aparte testomgeving. Testmodus-sleutels draaien tegen de Dodo-testhost, en er verplaatst geen echt geld.
- Log in op app.dodopayments.com.
- Dodo scheidt Live- en Test-sleutels. Stel eerst test in, herhaal dan in live.
- Kopieer uw API key
Ga naar Developer → API Keys en kopieer de Test-sleutel om te verifiëren, of de Live-sleutel om echte betalingen aan te nemen.
Dodo → Developer → API Keys - Voeg de webhook toe
- Voeg een webhook toe in Dodo.
- Stel de webhook-URL in op uw projectwebhook-adres (hieronder).
- Kopieer het webhook signing secret (whsec_…). Voeg een aparte webhook toe in test en in live.
https://api.coinmoebius.com/webhook/dodopayments/<your project id>Dodo → Developer → Webhooks - Verbind in het dashboard
Provider toevoegen → Dodo Payments. Voer de Return-URL en de Live-groep in (Live API key, Live webhook signing secret). Voeg de optionele Test-groep toe om eerst te verifiëren. De Test-groep is gepaard: voeg zowel een test-API key als een test-webhook secret toe, of laat beide leeg. Live en test worden apart gecontroleerd.
Nadat u verbindt
Voer één testbetaling uit voordat u live gaat:
- Maak een product aan en zet zijn Omgeving op Testing. Dat draait het product op uw test-inloggegevens, zodat u een volledige bestelling kunt plaatsen zonder geld te verplaatsen. (Als u de test-set oversloeg, valt een Testing-product terug op live, dus voeg hem eerst toe.)
- Plaats de buy button op een pagina (een lokaal HTML-bestand werkt) gericht op uw project.
- Rond de checkout af in de testmodus van Dodo.
- Open het tabblad Transacties. Een nieuwe rij verschijnt, gemarkeerd als Testing. Wanneer zijn status succeeded bereikt, werken zowel uw inloggegevens als webhook end-to-end.
Zet de Omgeving van het product op Live wanneer u klaar bent voor echte betalingen.
Problemen oplossen
Begin met Verifiëren. Klik in het dashboard op Verifiëren (of Testinloggegevens verifiëren) om uw API key te controleren.
Testinloggegevens verifiëren zegt dat er geen testinloggegevens zijn opgeslagen.
Voeg een test-API key toe in het Test-tabblad, sla de provider op, open dan het dialoogvenster opnieuw en verifieer.
Betaling voltooit maar de bestelling blijft in behandeling.
Bevestig dat de webhook-URL overeenkomt en dat het signing secret overeenkomt met de webhook in dezelfde omgeving (test-secret voor test, live voor live).
De Test-groep opslaan wordt geweigerd.
De Test-groep is gepaard: voeg zowel een test-API key als een test-webhook secret toe, of laat beide leeg.
Bevestig het end-to-end.
Dodo Dashboard → Developer → Webhooks → Send Example (of de Dodo CLI) gericht op uw webhook-URL, en kijk dan hoe de bestelling bijwerkt.
Goed om te weten
Alleen eenmalige betalingen. Coin Moebius gebruikt Dodo voor enkele betalingen, niet voor abonnementen.
Secrets roteren. Roteer de API key of het webhook secret wanneer u maar wilt, plak dan de nieuwe waarde. Geheime velden blijven leeg bij bewerken.
Vragen? Join our Discord