Πώληση φιλοξενίας Zinn® από τα δικά σας συστήματα

Μεταπωλείτε τη φιλοξενία μας. Οι πελάτες σας είναι δικοί σας: οι τιμές σας, τα τιμολόγιά σας, ο πάροχος πληρωμών σας. Με αυτόν τον τρόπο διαχειρίζεστε την πλατφόρμα μας μέσα από ό,τι ήδη χρησιμοποιείτε — έναν πίνακα χρέωσης, τον δικό σας ιστότοπο WordPress ή ένα script.

Τι βλέπουν πραγματικά οι πελάτες σας

Πριν από τα τεχνικά: οι πελάτες σας δεν χρειάζεται να μας δουν ποτέ. Τρία σημεία επαφής, και εσείς επιλέγετε ποιο θα χρησιμοποιήσετε.

⛔ Όποιο και αν επιλέξετε, εσείς είστε ο επίσημος έμπορος (merchant of record) για τους πελάτες σας: οι τιμές σας, τα τιμολόγιά σας, ο ΑΦΜ σας, ο πάροχος πληρωμών σας. Εμείς τιμολογούμε εσάς, μία φορά τον μήνα, σε τιμές χονδρικής.

Αφού ορίσετε ένα hostname πίνακα, εισαγάγετέ το στο πεδίο Διεύθυνση πίνακα του πρόσθετου WordPress και πουθενά αλλού — οι σύνδεσμοι σύνδεσης που παράγει αυτό το API το ακολουθούν αυτόματα.

Οι τέσσερις τρόποι πρόσβασης

Υπάρχουν τέσσερις τρόποι πρόσβασης, και όλοι κάνουν το ίδιο πράγμα στο παρασκήνιο:

1. Αποκτήστε ένα κλειδί API

Στον πίνακα ελέγχου σας, μεταβείτε στα Κλειδιά API και δημιουργήστε ένα. Εκχωρήστε του μόνο ό,τι χρειάζεται:

⛔ Μην εκχωρείτε το δικαίωμα reseller.manage σε μια ενσωμάτωση. Αυτό το δικαίωμα επεξεργάζεται τον τιμοκατάλογό σας και τα διαπιστευτήρια της δικής σας πύλης πληρωμών. Το reseller.provision υπάρχει ακριβώς ώστε ένα κλειδί που επικολλάτε σε έναν πίνακα χρέωσης ή σε έναν ιστότοπο να μην το χρειάζεται.

Το κλειδί εμφανίζεται μόνο μία φορά. Αποθηκεύστε το εκεί όπου φυλάσσετε τα υπόλοιπα διαπιστευτήριά σας — ποτέ σε αρχείο που σερβίρει ο διακομιστής ιστού σας.

2. Κάντε την πρώτη σας κλήση

curl https://api.zinndigital.com/v1/reseller/services \
  -H "Authorization: Bearer zdk_live_…"

Αυτό επιστρέφει κάθε υπηρεσία που έχετε διαμορφώσει, μία γραμμή ανά ιστότοπο, μαζί με τον πελάτη στον οποίο ανήκει, την κατάστασή της και το ποσό που χρεώνετε για αυτήν. Σε έναν νέο λογαριασμό επιστρέφει μια κενή λίστα — η οποία είναι η σωστή απάντηση, όχι σφάλμα.

3. Ολόκληρη η ενσωμάτωση, σε έξι κλήσεις

ΟΤΑΝ                       ΚΛΗΣΗ
πληρώνεται μια παραγγελία  POST   /v1/orgs                                   μία φορά ανά ΠΕΛΑΤΗ
                           POST   /v1/sites                                  μία φορά ανά ΥΠΗΡΕΣΙΑ
δεν έχουν πληρώσει         POST   /v1/reseller/services/{siteId}/suspend
πληρώνουν                  POST   /v1/reseller/services/{siteId}/unsuspend
ακυρώνουν                  DELETE /v1/sites/{siteId}
«σύνδεση στη φιλοξενία»    POST   /v1/reseller/services/{siteId}/sso

Η παροχή (provisioning) αποτελείται από δύο κλήσεις, και τα κλειδιά έχουν σημασία:

# 1. ο λογαριασμός του πελάτη — συσχετισμένος με το δικό ΣΑΣ id πελάτη
curl -X POST https://api.zinndigital.com/v1/orgs \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: account-4211" \
  -d '{"type":"customer","name":"Acme Ltd"}'

# 2. ο ιστότοπός τους — συσχετισμένος με το δικό ΣΑΣ id υπηρεσίας
curl -X POST https://api.zinndigital.com/v1/sites \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: service-9915" \
  -d '{"org_id":"<from step 1>","product_line":"mainstream","primary_domain":"acme.com"}'

Δύο κανόνες που κοστίζουν χρήματα αν γίνουν λάθος

1. Συσχετίστε τον λογαριασμό με τον ΠΕΛΑΤΗ σας και τον ιστότοπο με την ΥΠΗΡΕΣΙΑ σας. Μια δεύτερη παραγγελία πελάτη πρέπει να καταλήγει στον λογαριασμό που ήδη διαθέτει. Αν συσχετίσετε και τα δύο με την υπηρεσία, ένας πελάτης θα καταλήξει με τρεις άσχετους λογαριασμούς και τρεις ξεχωριστούς πίνακες.
2. Στέλνετε ένα Idempotency-Key σε κάθε POST, διαμορφωμένο από το δικό σας αναγνωριστικό (id) για το αντικείμενο. Κάθε σύστημα χρέωσης επαναλαμβάνει τις προσπάθειες — μια κλήση επιστροφής (callback) πύλης φτάνει δύο φορές, ένας διαχειριστής εκτελεί ξανά μια αποτυχημένη παροχή, ένας πελάτης κάνει διπλό κλικ. Χωρίς το κλειδί, η δεύτερη προσπάθεια δημιουργεί έναν δεύτερο ιστότοπο και τιμολογείστε για αυτόν.

Τρεις απαντήσεις που δεν πρέπει να εξομοιώνετε σε δύο

• Το unsuspend μπορεί να επιστρέψει 409. Αυτό σημαίνει ότι η ομάδα καταπολέμησης καταχρήσεων (abuse team) έχει δεσμεύσει τον ιστότοπο, όχι εσείς. Εμφανίστε το μήνυμα· μην επαναλάβετε την κλήση.
• **Ο τερματισμός προγραμματίζει μια διαγραφή, δεν την εκτελεί άμεσα.** Η ημερομηνία επιστρέφεται ως pending_deletion_at. Το να πείτε σε έναν πελάτη ότι τα δεδομένα του έχουν ήδη διαγραφεί ενώ δεν ισχύει κάτι τέτοιο είναι χειρότερο από το να μην του πείτε τίποτα.
• Το disk_used_bytes μπορεί να είναι null, και το null δεν είναι μηδέν. Σημαίνει ότι δεν μπορέσαμε να μετρήσουμε, όχι ότι δεν χρησιμοποιήθηκε τίποτα. Παραλείψτε το — μην καταχωρείτε 0 στα δικά σας αρχεία, διαφορετικά θα εμφανίσετε σε έναν πελάτη μια πράσινη μπάρα χρήσης για έναν ιστότοπο από τον οποίο δεν έχετε καμία μέτρηση.

4. Συνδέστε έναν πελάτη

Το POST /v1/reseller/services/{siteId}/sso επιστρέφει ένα URL μίας χρήσης που μεταφέρει τον πελάτη σας απευθείας στον δικό του λογαριασμό, ήδη συνδεδεμένο.

⛔ Δημιουργήστε το τη στιγμή που κάνουν κλικ, ποτέ κατά την απόδοση της σελίδας. Ο σύνδεσμος είναι μίας χρήσης και λήγει μέσα σε λίγα λεπτά, επομένως ένας σύνδεσμος ενσωματωμένος σε μια σελίδα αναλώνεται με την πρώτη προβολή της σελίδας και απομένει σε κάθε προσωρινή μνήμη (cache) ανάμεσα σε εσάς και το πρόγραμμα περιήγησης.

5. Εγκαταστήστε ένα module εναλλακτικά

• WHMCS — αντιγράψτε το module στο modules/servers/zinn/, προσθέστε έναν διακομιστή του οποίου το Password είναι το κλειδί API σας, και ορίστε τη σειρά προϊόντων στο προϊόν. Πατήστε Test Connection: εκτελεί μια πραγματική κλήση και σας ενημερώνει για την απόκριση της πλατφόρμας.
• HostBill — αντιγράψτε στο includes/modules/Hosting/zinn/ και συνδέστε το με τον ίδιο τρόπο.
• WordPress — το Zinn® Reseller Toolkit: αναζήτηση domain, ένας σύνδεσμος εισόδου στη φιλοξενία των πελατών σας και παροχή μέσω WooCommerce όταν πληρώνεται μια παραγγελία. Ανοιχτού κώδικα στο <https://github.com/Zinn-Digital/zinn-reseller-toolkit>, ή κατεβάστε το από τα Πρόσθετα στον πίνακα ελέγχου σας.

6. Ξεκινήστε την παραγωγική λειτουργία

Ελέγξτε τα εξής προτού λάβετε μια πραγματική παραγγελία:

• Ο έλεγχος σύνδεσης είναι επιτυχής στο module, ή η πρώτη σας εντολή curl επιστρέφει μια λίστα.
• Ο τιμοκατάλογός σας έχει οριστεί (Μεταπώληση → Οι τιμές σας).
• Η πύλη πληρωμών σας είναι συνδεδεμένη (Μεταπώληση → Πύλες πληρωμών) — οι πελάτες σας πληρώνουν εσάς, μέσω του δικού σας λογαριασμού.
• Τα στοιχεία της εταιρείας σας έχουν καταχωρηθεί (Μεταπώληση → Η εταιρεία σας) ώστε τα τιμολόγια των πελατών σας να φέρουν τη δική σας νομική οντότητα και τον ΑΦΜ σας, όχι τα δικά μας.
• Έχετε πραγματοποιήσει μία πραγματική παραγγελία από την αρχή ως το τέλος και είδατε τον ιστότοπο να εμφανίζεται.

Πού βρίσκονται όλα τα υπόλοιπα

Η πλήρης τεκμηρίωση του API — κάθε τελικό σημείο, παραγόμενο από τις προδιαγραφές μας, με το δικαίωμα που απαιτεί το καθένα — βρίσκεται στη διεύθυνση <https://zinndigital.com/developers/api>.