Dodo Payments

Τι χρειάζεστε

Γιατί ζητάμε κάθε πεδίο

API key

Εξουσιοδοτεί τη δημιουργία του φιλοξενούμενου checkout, ώστε η χρέωση να περάσει μέσα από τον λογαριασμό σας.

Webhook signing secret

Αποδεικνύει ότι ένα εισερχόμενο webhook προέρχεται πραγματικά από το Dodo, ώστε κανείς να μην μπορεί να πλαστογραφήσει ένα συμβάν "paid". Είναι ξεχωριστή τιμή από το API key.

Return URL

Απλή ρύθμιση: πού καταλήγει ο αγοραστής μετά το checkout. Δεν είναι μυστικό.

Ρύθμιση

1. Χρησιμοποιήστε τη λειτουργία δοκιμής (δωρεάν)

   Το Dodo έχει ξεχωριστό περιβάλλον δοκιμής. Τα κλειδιά λειτουργίας δοκιμής τρέχουν απέναντι στον host δοκιμής του Dodo, και δεν κινούνται πραγματικά χρήματα.

   1. Συνδεθείτε στο app.dodopayments.com.
   2. Το Dodo διαχωρίζει τα κλειδιά Live και Test. Ρυθμίστε πρώτα τη δοκιμή, μετά επαναλάβετε στο live.
2. Αντιγράψτε το API key σας

   Πηγαίνετε στο Developer → API Keys και αντιγράψτε το Test key για επαλήθευση, ή το Live key για να δέχεστε πραγματικές πληρωμές.

   ⤢
3. Προσθέστε το webhook
   1. Προσθέστε ένα webhook στο Dodo.
   2. Ορίστε το webhook URL στη διεύθυνση webhook του έργου σας (παρακάτω).
   3. Αντιγράψτε το webhook signing secret (whsec_…). Προσθέστε ξεχωριστό webhook σε test και σε live.

   https://api.coinmoebius.com/webhook/dodopayments/<your project id>

   ⤢
4. Συνδέστε στον πίνακα ελέγχου

   Add provider → Dodo Payments. Εισαγάγετε το Return URL και την ομάδα Live (Live API key, Live webhook signing secret). Προσθέστε την προαιρετική ομάδα Test για επαλήθευση πρώτα. Η ομάδα Test είναι ζευγαρωμένη: προσθέστε και ένα test API key και ένα test webhook secret, ή αφήστε και τα δύο κενά. Το live και το test ελέγχονται ξεχωριστά.

Αφού συνδεθείτε

Κάντε μία δοκιμαστική πληρωμή πριν βγείτε live:

1. Δημιουργήστε ένα προϊόν και ορίστε το Environment του σε Testing. Αυτό τρέχει το προϊόν στα διαπιστευτήρια δοκιμής σας, ώστε να κάνετε μια πλήρη παραγγελία χωρίς να κινηθούν χρήματα. (Αν παραλείψατε το σύνολο δοκιμής, ένα προϊόν Testing επιστρέφει στο live, οπότε προσθέστε το πρώτα.)
2. Τοποθετήστε το κουμπί αγοράς σε μια σελίδα (ένα τοπικό αρχείο HTML λειτουργεί) που δείχνει στο έργο σας.
3. Ολοκληρώστε το checkout στη λειτουργία δοκιμής του Dodo.
4. Ανοίξτε την καρτέλα Transactions. Μια νέα γραμμή εμφανίζεται, με ετικέτα Testing. Όταν η κατάστασή της φτάσει στο succeeded, τα διαπιστευτήριά σας και το webhook λειτουργούν και τα δύο από άκρη σε άκρη.

Αλλάξτε το Environment του προϊόντος σε Live όταν είστε έτοιμοι για πραγματικές πληρωμές.

Αντιμετώπιση προβλημάτων

Ξεκινήστε με το Verify. Στον πίνακα ελέγχου, κάντε κλικ στο Verify (ή Verify test credentials) για να ελέγξετε το API key σας.

Το Verify test credentials λέει ότι δεν έχουν αποθηκευτεί test credentials.

Προσθέστε ένα test API key στην καρτέλα Test, αποθηκεύστε τον πάροχο, μετά ανοίξτε ξανά τον διάλογο και επαληθεύστε.

Η πληρωμή ολοκληρώνεται αλλά η παραγγελία μένει σε εκκρεμότητα.

Επιβεβαιώστε ότι το webhook URL ταιριάζει και ότι το signing secret ταιριάζει με το webhook στο ίδιο περιβάλλον (test secret για test, live για live).

Η αποθήκευση της ομάδας Test απορρίπτεται.

Η ομάδα Test είναι ζευγαρωμένη: προσθέστε και ένα test API key και ένα test webhook secret, ή αφήστε και τα δύο κενά.

Επιβεβαιώστε το από άκρη σε άκρη.

Dodo Dashboard → Developer → Webhooks → Send Example (ή το Dodo CLI) στραμμένο στο webhook URL σας, και μετά παρακολουθήστε την παραγγελία να ενημερώνεται.

Καλό να γνωρίζετε

Μόνο εφάπαξ πληρωμές. Το Coin Moebius χρησιμοποιεί το Dodo για μεμονωμένες πληρωμές, όχι για συνδρομές.

Εναλλαγή μυστικών. Αλλάξτε το API key ή το webhook secret οποτεδήποτε, μετά επικολλήστε τη νέα τιμή. Τα μυστικά πεδία μένουν κενά κατά την επεξεργασία.

Ερωτήσεις; Join our Discord