saphire-exim
Stripe Webhooks
Stripe Webhooks στο Workadu
Με τη διασύνδεση Stripe Webhooks, το Workadu λαμβάνει τις επιτυχημένες πληρωμές από τη Stripe και δημιουργεί αυτόματα το αντίστοιχο παραστατικό, σύμφωνα με τις σειρές και τις ρυθμίσεις που έχετε επιλέξει.
Ο οδηγός περιγράφει την εγκατάσταση, τη δοκιμή και τα βασικά σημεία που πρέπει να ελέγξετε πριν ενεργοποιήσετε τη live λειτουργία.
Τι θα χρειαστείτε
- Ενεργό λογαριασμό Workadu — δημιουργήστε δωρεάν λογαριασμό.
- Ενεργό λογαριασμό Stripe με δικαιώματα πρόσβασης στα Developers.
- Κωδικούς διασύνδεσης με ΑΑΔΕ myDATA, εφόσον θέλετε να ολοκληρώσετε τη διαδικασία έκδοσης και διαβίβασης.
- Ενεργό πλάνο τιμολόγησης και διασύνδεση με πάροχο, όταν αυτά απαιτούνται για τη δική σας ροή. Για τις αρχικές δοκιμές επικοινωνήστε με την υποστήριξη, ώστε να επιβεβαιωθούν οι διαθέσιμες ρυθμίσεις.
Πώς λειτουργεί η διασύνδεση
- Η Stripe αποστέλλει το event της επιτυχημένης πληρωμής στο webhook endpoint του Workadu.
- Το Workadu διαβάζει τα διαθέσιμα στοιχεία της πληρωμής και του Stripe Customer.
- Αν εντοπιστεί ΑΦΜ / VAT ID στον Stripe Customer, εκδίδεται τιμολόγιο. Αν δεν εντοπιστεί, εκδίδεται απόδειξη.
- Η σειρά παραστατικού επιλέγεται με βάση τη χώρα του πελάτη και την ύπαρξη ΑΦΜ, σύμφωνα με τις σειρές που έχετε ρυθμίσει.
1. Δημιουργία του webhook στη Stripe
- Συνδεθείτε στο Stripe Dashboard.
- Ανοίξτε την ενότητα Developers και στη συνέχεια Webhooks ή Event Destinations. Η ονομασία μπορεί να διαφέρει ανάλογα με την έκδοση του Stripe Dashboard.
- Πατήστε Add endpoint ή Add destination.
- Προσθέστε το event
payment_intent.succeeded. - Στο Endpoint URL γράψτε προσωρινά https://workadu.com. Θα χρειαστεί να αλλάξετε ξανά αυτό το πεδίο αργότερα, στο βήμα 4.
- Αποθηκεύστε το endpoint.
2. Αντιγραφή του signing secret
Ανοίξτε το endpoint που δημιουργήσατε, βρείτε την ενότητα Signing secret και πατήστε Reveal. Αντιγράψτε ολόκληρη την τιμή, χωρίς κενά στην αρχή ή στο τέλος.
3. Σύνδεση στο Workadu
- Ανοίξτε το Workadu.
- Πατήστε το εικονίδιο του παζλ κάτω αριστερά και επιλέξτε Εφαρμογές.
- Ανοίξτε την κατηγορία Αυτοματισμοί, βρείτε το Stripe Webhooks και πατήστε Διασύνδεση.
- Στο πεδίο Stripe signed hash code επικολλήστε το signing secret από το προηγούμενο βήμα.
- Στο πεδίο Stripe API Secret key επικολλήστε το Secret key από το Developers > API keys στη Stripe.
- Στη συνέχεια πατήστε Ενεργοποίηση εφαρμογής Stripe Webhooks.
4. Αντιγραφή του webhook URL από το Workadu
Στην ίδια οθόνη της διασύνδεσης Stripe Webhooks στο Workadu, βρείτε το πεδίο Register this webhook και αντιγράψτε ολόκληρο το URL που εμφανίζεται. Αυτό είναι το webhook URL της διασύνδεσης και όχι το URL της σελίδας οδηγιών.
Επιστρέψτε στη Stripe, ανοίξτε το endpoint που δημιουργήσατε, πατήστε Edit destination και στο Endpoint URL αντικαταστήστε το προσωρινό https://workadu.com με το URL που αντιγράψατε από το Workadu. Πατήστε Save.
5. Επιλογή σειρών παραστατικών
Επιλέξτε τις σειρές παραστατικών που θα χρησιμοποιούνται και πατήστε Αποθήκευση και σύνδεση.
Επιλέξτε τη σωστή σειρά για κάθε κατηγορία συναλλαγής. Το Workadu χρησιμοποιεί τη χώρα του πελάτη και την ύπαρξη ΑΦΜ στον Stripe Customer για να επιλέξει την κατάλληλη σειρά.
| Περίπτωση | Σειρά που επιλέγεται στη διασύνδεση |
|---|---|
| Ελλάδα χωρίς ΑΦΜ | Σειρά webhook απόδειξης Ελλάδας |
| Ελλάδα με ΑΦΜ | Σειρά webhook B2B Ελλάδας |
| Ευρωπαϊκή Ένωση εκτός Ελλάδας χωρίς ΑΦΜ | Σειρά webhook απόδειξης ΕΕ |
| Ευρωπαϊκή Ένωση εκτός Ελλάδας με ΑΦΜ | Σειρά webhook B2B ΕΕ |
| Τρίτη χώρα χωρίς ΑΦΜ | Σειρά webhook απόδειξης τρίτων χωρών |
| Τρίτη χώρα με ΑΦΜ | Σειρά webhook B2B τρίτων χωρών |
Αν ο τύπος ή η σειρά που χρειάζεστε δεν εμφανίζεται, επικοινωνήστε με την υποστήριξη πριν ενεργοποιήσετε τη διασύνδεση.
6. Έλεγχος και ενεργοποίηση
Για να μειώσετε τον κίνδυνο να σταλεί κατά λάθος παραστατικό στην ΑΑΔΕ, πριν από τη δοκιμή μπορείτε να ανοίξετε τις ρυθμίσεις λογαριασμού και να προσθέσετε προσωρινά έναν κενό χαρακτήρα στον ΑΦΜ της επιχείρησης ή να αφαιρέσετε ένα ψηφίο. Μετά τις δοκιμές επαναφέρετε τον σωστό ΑΦΜ πριν από τη live λειτουργία.
- Επιβεβαιώστε ότι το Stripe endpoint είναι ενεργό και ότι χρησιμοποιεί το σωστό signing secret.
- Πραγματοποιήστε μία δοκιμαστική πληρωμή και ελέγξτε στο Workadu την έκδοση του παραστατικού.
Δοκιμές χωρίς πραγματική χρέωση
Μπορείτε να κάνετε δοκιμές με το Stripe test mode / sandbox, χρησιμοποιώντας test API keys και το αντίστοιχο webhook signing secret. Οι test πληρωμές της Stripe δεν μεταφέρουν πραγματικά χρήματα.
Πριν πάτε live
- Επαναφέρετε τον σωστό ΑΦΜ στις ρυθμίσεις λογαριασμού.
- Αντικαταστήστε τα test API keys και το test signing secret με τα live στοιχεία, όπου απαιτείται (θα πρέπει να γίνει απενεργοποίηση και ξανά ενεργοποίηση της διασύνδεσης).
- Επιβεβαιώστε τις σειρές, τον ΦΠΑ, το myDATA και τον πάροχο με τον λογιστή σας και την υποστήριξη.
- Κάντε μία τελευταία ελεγχόμενη συναλλαγή και επιβεβαιώστε ότι το παραστατικό εμφανίζεται σωστά στο Workadu.
Συχνές ερωτήσεις
Πότε εκδίδεται τιμολόγιο και πότε απόδειξη;
Το Workadu αναζητά ΑΦΜ / VAT ID στον Stripe Customer. Αν βρεθεί ΑΦΜ, εκδίδεται τιμολόγιο. Αν δεν βρεθεί, εκδίδεται απόδειξη.
Από πού αντλούνται τα στοιχεία του πελάτη;
Όταν υπάρχει Stripe Customer, χρησιμοποιούνται τα στοιχεία του. Εναλλακτικά ανακτώνται τα στοιχεία χρέωσης από το charges.data[0].billing_details ή από το Charge που αντιστοιχεί στο latest_charge.
| Στοιχείο | Stripe Customer | Charge billing details |
|---|---|---|
| Ονοματεπώνυμο / επωνυμία | name | billing_details.name |
email | billing_details.email | |
| Τηλέφωνο | phone | billing_details.phone |
| Διεύθυνση | address.line1 | billing_details.address.line1 |
| Πόλη | address.city | billing_details.address.city |
| Ταχυδρομικός κώδικας | address.postal_code | billing_details.address.postal_code |
| Χώρα | address.country | billing_details.address.country |
Πώς επιλέγεται η σειρά παραστατικού;
Η επιλογή βασίζεται στη χώρα του πελάτη και στην ύπαρξη ΑΦΜ στον Stripe Customer. Για αυτό πρέπει να έχετε συμπληρώσει τις αντίστοιχες σειρές στη διασύνδεση.
Τα πεδία επιλογής σειρών είναι κενά. Τι κάνω;
Αν η διασύνδεση λειτουργεί αλλά τα πεδία επιλογής σειρών εμφανίζονται κενά, πιθανότατα χρησιμοποιείτε την παλαιότερη υλοποίηση. Για αλλαγή σειρών ή δρομολόγησης παραστατικών επικοινωνήστε με την υποστήριξη του Workadu.
Από πού προκύπτει η περιγραφή προϊόντος ή υπηρεσίας;
Στα Checkout line items διαβάζεται το πεδίο description κάθε γραμμής. Στο payload εμφανίζεται ως line_items.data[].description, ενώ στην απόκριση του Stripe endpoint των line items ως data[].description. Αν δεν υπάρχουν Checkout line items, χρησιμοποιείται το data.object.description του PaymentIntent. Αν και αυτό είναι κενό, χρησιμοποιείται η προεπιλεγμένη περιγραφή της πρώτης γραμμής της σειράς στο Workadu.
Πώς λειτουργεί ο ΦΠΑ ανά χώρα και το OSS;
Για συναλλαγές προς πελάτη σε χώρα της Ευρωπαϊκής Ένωσης εκτός Ελλάδας, όταν χρησιμοποιείται σειρά που υποστηρίζει OSS, η διασύνδεση διαβάζει τον φορολογικό συντελεστή που συνοδεύει τη γραμμή του Stripe Checkout και τον αποθηκεύει ως ΦΠΑ OSS μαζί με τη χώρα κατανάλωσης.
Η καθαρή αξία υπολογίζεται από το ποσό της γραμμής και τον συντελεστή που έστειλε η Stripe. Για παράδειγμα, όταν η Stripe έχει υπολογίσει 19% για ιδιώτη στη Γερμανία, η ανάλυση του παραστατικού χρησιμοποιεί τον γερμανικό συντελεστή και όχι τον ελληνικό 24%.
Για διαφορετικούς συντελεστές ανά χώρα πρέπει να έχουν ρυθμιστεί σωστά τα φορολογικά στοιχεία στη Stripe, συνήθως μέσω Stripe Tax. Αν δεν σταλεί φορολογικός συντελεστής από τη Stripe, εφαρμόζεται η προεπιλεγμένη φορολογική ρύθμιση της σειράς ή του Workadu.
Στις σειρές OSS το Workadu διατηρεί τη χώρα και τον συντελεστή OSS για την ανάλυση του παραστατικού και τη σχετική φορολογική διαβίβαση. Οδηγίες Stripe Tax για Checkout
Τι γίνεται αν η Stripe ξαναστείλει την ίδια πληρωμή;
Το Workadu κρατά το μοναδικό ID της πληρωμής και δεν δημιουργεί διπλότυπο παραστατικό για την ίδια πληρωμή.
Τι πρέπει να ελέγξω αν μια δοκιμή δεν ολοκληρωθεί;
Ελέγξτε ότι χρησιμοποιείτε test στοιχεία με test endpoint ή live στοιχεία με live endpoint, ότι το event έχει προστεθεί στο webhook και ότι η διασύνδεση στο Workadu έχει αποθηκευτεί με το σωστό signing secret. Αν το πρόβλημα συνεχίζεται, επικοινωνήστε με την υποστήριξη.
Σχετικά άρθρα
saphire-exim
Θα Επιβραδύνει το myDATA το Checkout του WooCommerce μου;
saphire-exim
Χρειάζομαι το myDATA Αν Ήδη Χρησιμοποιώ Stripe Invoicing ή Stripe Tax;
saphire-exim
Είναι το Shopify Ήδη Συμβατό με το myDATA;
saphire-exim
Διασύνδεση WooCommerce με myDATA: Αυτόματη Τιμολόγηση Χωρίς Plugin
saphire-exim
Διασύνδεση Stripe με myDATA: Αυτόματη Μετατροπή Πληρωμών σε Παραστατικά
saphire-exim
Διασύνδεση Shopify με myDATA: Αυτόματη Τιμολόγηση για e-shops
saphire-exim
Novus Conceptus
saphire-exim
Impact
saphire-exim
Eventbrite webhook
saphire-exim
EFT POS
saphire-exim
Woocommerce webhook
saphire-exim
Viva Webhook