Stripe Webhooks

Stripe Webhooks

Stripe Webhooks στο Workadu

Με τη διασύνδεση Stripe Webhooks, το Workadu λαμβάνει τις επιτυχημένες πληρωμές από τη Stripe και δημιουργεί αυτόματα το αντίστοιχο παραστατικό, σύμφωνα με τις σειρές και τις ρυθμίσεις που έχετε επιλέξει.

Ο οδηγός περιγράφει την εγκατάσταση, τη δοκιμή και τα βασικά σημεία που πρέπει να ελέγξετε πριν ενεργοποιήσετε τη live λειτουργία.

Σημαντικό: Για φορολογικές ρυθμίσεις, συντελεστές ΦΠΑ και τη διαβίβαση στο myDATA, επιβεβαιώστε τις επιλογές σας με τον λογιστή σας.

Τι θα χρειαστείτε

  • Ενεργό λογαριασμό Workadu — δημιουργήστε δωρεάν λογαριασμό.
  • Ενεργό λογαριασμό Stripe με δικαιώματα πρόσβασης στα Developers.
  • Κωδικούς διασύνδεσης με ΑΑΔΕ myDATA, εφόσον θέλετε να ολοκληρώσετε τη διαδικασία έκδοσης και διαβίβασης.
  • Ενεργό πλάνο τιμολόγησης και διασύνδεση με πάροχο, όταν αυτά απαιτούνται για τη δική σας ροή. Για τις αρχικές δοκιμές επικοινωνήστε με την υποστήριξη, ώστε να επιβεβαιωθούν οι διαθέσιμες ρυθμίσεις.

Πώς λειτουργεί η διασύνδεση

  1. Η Stripe αποστέλλει το event της επιτυχημένης πληρωμής στο webhook endpoint του Workadu.
  2. Το Workadu διαβάζει τα διαθέσιμα στοιχεία της πληρωμής και του Stripe Customer.
  3. Αν εντοπιστεί ΑΦΜ / VAT ID στον Stripe Customer, εκδίδεται τιμολόγιο. Αν δεν εντοπιστεί, εκδίδεται απόδειξη.
  4. Η σειρά παραστατικού επιλέγεται με βάση τη χώρα του πελάτη και την ύπαρξη ΑΦΜ, σύμφωνα με τις σειρές που έχετε ρυθμίσει.

1. Δημιουργία του webhook στη Stripe

  1. Συνδεθείτε στο Stripe Dashboard.
  2. Ανοίξτε την ενότητα Developers και στη συνέχεια Webhooks ή Event Destinations. Η ονομασία μπορεί να διαφέρει ανάλογα με την έκδοση του Stripe Dashboard.
  3. Πατήστε Add endpoint ή Add destination.
  4. Προσθέστε το event payment_intent.succeeded.
  5. Στο Endpoint URL γράψτε προσωρινά https://workadu.com. Θα χρειαστεί να αλλάξετε ξανά αυτό το πεδίο αργότερα, στο βήμα 4.
  6. Αποθηκεύστε το endpoint.
Δημιουργία Stripe webhook

2. Αντιγραφή του signing secret

Ανοίξτε το endpoint που δημιουργήσατε, βρείτε την ενότητα Signing secret και πατήστε Reveal. Αντιγράψτε ολόκληρη την τιμή, χωρίς κενά στην αρχή ή στο τέλος.

Stripe webhook signing secret

3. Σύνδεση στο Workadu

  1. Ανοίξτε το Workadu.
  2. Πατήστε το εικονίδιο του παζλ κάτω αριστερά και επιλέξτε Εφαρμογές.
  3. Ανοίξτε την κατηγορία Αυτοματισμοί, βρείτε το Stripe Webhooks και πατήστε Διασύνδεση.
  4. Στο πεδίο Stripe signed hash code επικολλήστε το signing secret από το προηγούμενο βήμα.
  5. Στο πεδίο Stripe API Secret key επικολλήστε το Secret key από το Developers > API keys στη Stripe.
  6. Στη συνέχεια πατήστε Ενεργοποίηση εφαρμογής Stripe Webhooks.
Ρυθμίσεις Stripe Webhooks στο Workadu

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 λειτουργία.

  1. Επιβεβαιώστε ότι το Stripe endpoint είναι ενεργό και ότι χρησιμοποιεί το σωστό signing secret.
  2. Πραγματοποιήστε μία δοκιμαστική πληρωμή και ελέγξτε στο Workadu την έκδοση του παραστατικού.

Δοκιμές χωρίς πραγματική χρέωση

Μπορείτε να κάνετε δοκιμές με το Stripe test mode / sandbox, χρησιμοποιώντας test API keys και το αντίστοιχο webhook signing secret. Οι test πληρωμές της Stripe δεν μεταφέρουν πραγματικά χρήματα.

Οδηγίες δοκιμών 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 CustomerCharge billing details
Ονοματεπώνυμο / επωνυμίαnamebilling_details.name
Emailemailbilling_details.email
Τηλέφωνοphonebilling_details.phone
Διεύθυνσηaddress.line1billing_details.address.line1
Πόληaddress.citybilling_details.address.city
Ταχυδρομικός κώδικαςaddress.postal_codebilling_details.address.postal_code
Χώραaddress.countrybilling_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. Αν το πρόβλημα συνεχίζεται, επικοινωνήστε με την υποστήριξη.

Χρειάζεστε βοήθεια; Μην αλλάξετε φορολογικές ρυθμίσεις ή σειρές χωρίς προηγούμενο έλεγχο. Επικοινωνήστε με την υποστήριξη του Workadu για να ελεγχθεί η συγκεκριμένη ροή του λογαριασμού σας.