Αποστολή παραγγελιών στο Zapier, στο Make και σε άλλες εφαρμογές με webhooks

Ένα webhook στέλνει τα συμβάντα του καταστήματός σας σε μια άλλη εφαρμογή τη στιγμή που συμβαίνουν. Προσθέστε ένα και κάθε πληρωμένη παραγγελία μπορεί να φτάνει στο Zapier ή στο Make και από εκεί στο Google Sheets, στο Slack, στη λίστα email σας, στην εφαρμογή λογιστικής σας και σε χιλιάδες ακόμη. Δεν χρειάζεται κώδικας.

Προσθήκη webhook

1. Στον πίνακα ελέγχου του ιστότοπού σας, κάντε κλικ στις Ενσωματώσεις.
2. Στην ενότητα Αυτοματισμός, ενεργοποιήστε το Webhooks. Ανοίγει ένα αναδυόμενο παράθυρο.

   

3. Επιλέξτε ένα Συμβάν, επικολλήστε τη Διεύθυνση webhook που σας έδωσε η εφαρμογή σας και κάντε κλικ στο Προσθήκη webhook.
4. Κάντε κλικ στο Αποστολή δοκιμής για να στείλετε μια δοκιμαστική παραγγελία και έπειτα στο Τέλος.

   

Τα webhooks αρχίζουν να λειτουργούν μόλις τα προσθέσετε. Δεν χρειάζεται να δημοσιεύσετε.

Σύνδεση με το Zapier

1. Στο Zapier, δημιουργήστε ένα Zap. Ως έναυσμα επιλέξτε Webhooks by Zapier και έπειτα Catch Hook.
2. Αντιγράψτε το URL του webhook που σας δείχνει το Zapier.
3. Στην Payly, προσθέστε ένα webhook για το συμβάν Η παραγγελία πληρώθηκε και επικολλήστε αυτό το URL.
4. Κάντε κλικ στο Αποστολή δοκιμής. Πίσω στο Zapier, κάντε κλικ στο Test trigger. Θα δείτε τη δοκιμαστική παραγγελία, #9999 για τον John Smith.
5. Προσθέστε την ενέργεια που θέλετε, όπως μια νέα γραμμή στο Google Sheets, και αντιστοιχίστε τα πεδία: Order Number, Order Total, Order Customer Email και ούτω καθεξής.
6. Δημοσιεύστε το Zap. Κάθε πληρωμένη παραγγελία πλέον το εκτελεί.

Το Webhooks by Zapier είναι μία από τις premium εφαρμογές του Zapier, οπότε απαιτεί επί πληρωμή πλάνο Zapier.

Σύνδεση με το Make

1. Στο Make, δημιουργήστε ένα σενάριο. Προσθέστε το Webhooks, έπειτα το Custom webhook και κάντε κλικ στο Add για να δημιουργήσετε ένα νέο webhook.
2. Αντιγράψτε τη διεύθυνση που σας δείχνει το Make.
3. Στην Payly, προσθέστε ένα webhook με αυτή τη διεύθυνση και κάντε κλικ στο Αποστολή δοκιμής. Το Make διαβάζει το δείγμα και μαθαίνει τα πεδία.
4. Προσθέστε τα modules που θέλετε, αντιστοιχίστε τα πεδία και ενεργοποιήστε το σενάριο.

Συμβάντα

• Η παραγγελία πληρώθηκε: μια παραγγελία πληρώνεται. Αυτό περιλαμβάνει την πρώτη πληρωμή μιας συνδρομής, κάθε ανανέωση και μια παραγγελία που προσθέτετε με το χέρι ως πληρωμένη.
• Η παραγγελία εστάλη: σημειώνετε μια παραγγελία ως απεσταλμένη. Όταν στέλνετε μια παραγγελία τμηματικά, αποστέλλεται ξεχωριστό συμβάν για κάθε αποστολή.
• Επιστροφή χρημάτων παραγγελίας: τα χρήματα επιστρέφονται, είτε κάνετε την επιστροφή από την Payly είτε από το Stripe ή το PayPal. Στέλνεται και κάθε μερική επιστροφή.
• Η συνδρομή ξεκίνησε: η πρώτη παραγγελία μιας συνδρομής.
• Η συνδρομή ανανεώθηκε: κάθε πληρωμή μετά την πρώτη.
• Η συνδρομή έληξε: μια συνδρομή ακυρώνεται ή λήγει, την ημέρα που τελειώνει.

Τι στέλνει η Payly

Κάθε συμβάν στέλνεται ως JSON. Κάθε συμβάν παραγγελίας περιλαμβάνει:

• Τον αριθμό παραγγελίας, όπως #1000, την κατάστασή της και πότε πληρώθηκε
• Το υποσύνολο, την έκπτωση και τον κωδικό έκπτωσης, την αποστολή, τον φόρο, το σύνολο και το ποσό που επιστράφηκε, μαζί με το νόμισμα
• Το όνομα, το SKU, την ποσότητα, την τιμή και το σύνολο γραμμής κάθε προϊόντος
• Το όνομα, το email και το τηλέφωνο του πελάτη, καθώς και τη διεύθυνση αποστολής
• Πώς πληρώθηκε, όπως με Stripe ή PayPal
• test_mode, που είναι true για μια παραγγελία που έγινε σε λειτουργία δοκιμής

Οι αποστολές προσθέτουν τη μεταφορική εταιρεία και τον αριθμό παρακολούθησης. Οι επιστροφές χρημάτων προσθέτουν το συνολικό ποσό που έχει επιστραφεί μέχρι τώρα. Τα συμβάντα συνδρομής προσθέτουν το πλάνο, την τιμή του, κάθε πότε χρεώνεται και την ημερομηνία της επόμενης ανανέωσης. Ένα δείγμα που στέλνεται με το κουμπί Αποστολή δοκιμής περιέχει "test": true. Οι αριθμοί καρτών μένουν στο Stripe και στο PayPal, οπότε δεν υπάρχουν ποτέ σε ένα webhook.

Αν ένα webhook αποτύχει

Μια εφαρμογή έχει 5 δευτερόλεπτα για να απαντήσει. Αν δεν απαντήσει ή απαντήσει με σφάλμα, η Payly προσπαθεί ξανά έως και 7 φορές ακόμη μέσα σε περίπου τέσσερις ώρες και μισή. Το αναδυόμενο παράθυρο Webhooks εμφανίζει τις πρόσφατες παραδόσεις κάθε webhook, ώστε να βλέπετε τι συνέβη.

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

Έλεγχος ότι ένα webhook προήλθε από το κατάστημά σας

Το Zapier και το Make δεν το χρειάζονται. Αν δημιουργείτε τη δική σας εφαρμογή, κάθε αίτημα έχει μια κεφαλίδα X-Payly-Hmac-Sha256: το σώμα του αιτήματος υπογεγραμμένο με HMAC-SHA256 χρησιμοποιώντας το μυστικό υπογραφής του καταστήματός σας, σε base64. Το μυστικό βρίσκεται στο αναδυόμενο παράθυρο Webhooks. Υπολογίστε την ίδια υπογραφή από το ακατέργαστο σώμα και συγκρίνετε τις δύο.

Η κεφαλίδα X-Payly-Webhook-Id μένει ίδια όταν μια παράδοση δοκιμάζεται ξανά, ώστε η εφαρμογή σας να μπορεί να παραλείψει μια που έχει ήδη χειριστεί.