Alpha Bank – Cardlink Nexi: Οδηγός Σύνδεσης

Οδηγός σύνδεσης της Alpha Bank με Cardlink για online πληρωμές.

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

Δεν χρειάζεται να έχετε τεχνικές γνώσεις – απλώς ακολουθήστε τα βήματα όπως τα περιγράφουμε.

Τι πρέπει να έχετε πριν ξεκινήσετε #

Τι πρέπει να έχετε έτοιμο #

• Λογαριασμό στο developer.cardlink.gr
• Πρόσβαση στο διαχειριστικό περιβάλλον της ιστοσελίδας σας (admin panel)

💡 TIP: Καλό είναι να έχετε ανοιχτές δύο καρτέλες στον browser σας

• Μία με το διαχειριστικό της ιστοσελίδας
• Μία με το Cardlink

Έτσι, θα μπορείτε να κάνετε εύκολα αντιγραφή/επικόλληση μεταξύ των δύο.

Δημιουργία λογαριασμού στο Cardlink #

Φτιάξτε τον λογαριασμό σας #

🔑 Τι κάνετε εδώ: Δημιουργείτε τον λογαριασμό σας στο Cardlink. Αυτό είναι το πρώτο και βασικό βήμα για να ξεκινήσετε τη διαδικασία σύνδεσης.

1. Επισκέπτεσαι τη σελίδα: developer.cardlink.gr
2. Επιλέξτε Register για να δημιουργήσετε τον λογαριασμό σας, ή Login αν έχετε ήδη.

Ωραία, αυτό ήταν. Πάμε τώρα στο επόμενο. 👍

Δημιουργία νέας εφαρμογής (App) #

Ρυθμίσεις για την εφαρμογή Cardlink – Πολύ Σημαντικό Βήμα! #

🔑 Τι κάνετε εδώ: Δημιουργείτε μια “εφαρμογή” στο Cardlink — η εφαρμογή θα συνδέει την ιστοσελίδα σας με το σύστημα πληρωμών.

Συνδεθείτε στον λογαριασμό σας, δημιουργήστε μια νέα εφαρμογή ‘Create a new App’ και εισάγετε τα στοιχεία.

• Application Name: Βάλτε ένα όνομα, π.χ. “My Site” .
• Merchant URL: Πληκτρολογείτε μόνο το όνομα του site σας, π.χ. “mysite.gr”
  
  🚨 Προσοχή: Δεν είναι αποδεκτό το “https://mysite.gr/” ή το “mysite.gr/”.
  
• Integration Model: Επιλέξτε Redirect
• Business Partner: Επιλέξτε Nexi

Έπειτα:

• Ενεργοποιείτε την επιλογή Send background confirmation
• Και εμφανίζετε ένα νέο πεδίο, προς το παρόν, ας μείνει κενό. Θα το συμπληρώσετε στο επόμενο βήμα.

🚀 Έτοιμο και αυτό — συνεχίζουμε !! 💪

Ρυθμίσεις στην ιστοσελίδα σας #

🔑 Τι κάνετε εδώ: Ρυθμίζετε την ιστοσελίδα σας ώστε να μπορεί να επικοινωνεί με το σύστημα πληρωμών του Cardlink.

1. Ανοίξτε το admin panel της ιστοσελίδας σας.
2. Πηγαίνετε στο Bookings > Gateway Settings.
3. Επιλέξτε Alpha Bank και συμπληρώνετε τα εξής:
   • Instant Payment Notification URL (Webhook): Αντιγράψτε αυτό το URL, θα το είναι χρήσιμο στο Cardlink.
   • Merchant ID: Προσωρινά, βάλτε το 1. Αργότερα, αντικαθιστάτε αυτήν την τιμή με τα σωστά στοιχεία.
   • Secret: Προσωρινά, βάλτε το 1. Αργότερα, αντικαθιστάτε αυτήν την τιμή με τα σωστά στοιχεία.
   • Merchant Email: Το email που αντιστοιχεί στην ιστοσελίδα σας.
4. Τέλος, Save Changes

🔗 Μέχρι εδώ πάτε πολύ καλά! Πάμε τώρα, να δέσουμε τα κομμάτια. 🔗

Ολοκλήρωση στο Cardlink #

Σύνδεση των συστημάτων – Η πιο κρίσιμη ρύθμιση #

🔑 Τι κάνετε εδώ: Δίνετε στο site σας τις απαραίτητες πληροφορίες για να συνδεθεί με το Cardlink.

1. Αρχικά, επιστρέψτε στο περιβάλλον του Cardlink (στην άλλη καρτέλα 😉).
2. Στο πεδίο Send background confirmation, βάζετε το URL που έχετε αντιγράψει από το site.
3. Τέλος, πατάτε Create App .
   

Σύνδεση του Cardlink με το site σας #

Το site σας είναι σχεδόν έτοιμο να δεχτεί online πληρωμές! #

🔑 Τι κάνετε εδώ: Παίρνετε τα τεχνικά στοιχεία (MID και Secret Key) από την εφαρμογή που δημιουργήσατε στο Cardlink και τα εισάγετε στην ιστοσελίδα σας. Έτσι, οι δύο πλευρές θα συνδεθούν και όταν ο πελάτης πατήσει “πληρωμή”, το σύστημα γνωρίζει πού να στείλει τα δεδομένα.

1. Από το Dashboard του Cardlink, επιλέξτε το App που δημιουργήσατε.
2. Πατάτε Configure.
3. Αντιγράψτε το πεδίο MID.
4. Μεταβείτε στη ιστοσελίδα  Bookings > Gateway Settings > Alphabank
5. Στο πεδίο Merchant ID, περνάτε το MID.
6. Επιστρέψτε στο Cardlink και αντιγράψτε το Shared Secret Key.
7. Μεταφέρετε το στο πεδίο Secret στο site σας.

🙌 Ας πάρουμε μια ανάσα πριν συνεχίσουμε. 🙌

1. Redirect Message: Το μήνυμα που θα βλέπει ο πελάτης όταν μεταβαίνει στο περιβάλλον πληρωμής.
   Π.χ.: You are being redirected to Nexi Payments secure environment…
2. Enable Test Environment: Τσεκάρετε το κουτάκι για να κάνετε δοκιμές.
3. Display Title: Το όνομα της μεθόδου πληρωμής που βλέπει ο πελάτης.
   Π.χ.: Credit/Debit card secure payment
4. Display Instruction: Σύντομη περιγραφή κάτω από τον τρόπο πληρωμής που θα βλέπει ο πελάτης.
   Π.χ.: Pay securely using your credit/debit card
5. Τέλος, Save Changes

🦾 Σχεδόν τελειώσαμε! Πιες λίγο καφέ και συνεχίζουμε.🧋

Δημιουργία Δοκιμαστικής Κράτησης #

Δοκιμάζουμε αν όλα λειτουργούν άψογα #

🔑 Τι κάνετε εδώ: Εκτελείτε μια δοκιμαστική συναλλαγή για να ελέγξετε ότι η ρύθμιση έχει γίνει σωστά. Σκέφτεστε το σαν εξής: “Αν ήμουν κανονικός πελάτης, θα μπορούσα να πληρώσω;”. Με αυτό το βήμα, επιβεβαιώνετε ότι η σύνδεση ανάμεσα στην ιστοσελίδα και το Cardlink λειτουργεί όπως πρέπει.

Από το διαχειριστικό της ιστοσελίδας και πηγαίνετε εκεί που προσθέτετε κρατήσεις (Accommodation, Travel κ.λπ.)
📌 Σημείωση:  Αν δεν γνωρίζετε πού ακριβώς είναι αυτή η ρύθμιση, ανατρέξτε στον σχετικό οδηγό της πλατφόρμας σας.

1. Αρχικά, δημιουργείτε ένα νέο αντικείμενο με όνομα “Test”
2. Και στην συνέχεια, βάλτε διαθεσιμότητα για 2–3 μέρες και τιμή 0.01 €
   📌 Σημείωση: Η τιμή δεν πρέπει να ξεπερνάει τα 0.10 € και πρέπει να περιλαμβάνει τελεία ” . ” .

1. Κάντε κράτηση για το “Test” και επιλέξτε πληρωμή με κάρτα
2. Πηγαίνετε στο Cardlink → Starter Guide > Test Cards
3. Αντιγράψτε αριθμούς δοκιμαστικών καρτών.

Επιλέξτε:

• Οποιοδήποτε όνομα κατόχου, ημερομηνία, CVV
• 2–3 κάρτες Mastercard και 2–3 Visa από τη λίστα

💡 TIP: Αν κάποια πληρωμή δεν περάσει ως “Confirm”,δοκιμάστε με άλλη κάρτα. Σκοπός: 2–3 επιτυχημένες συναλλαγές ανά τύπο κάρτας

🚀 Καλή δουλειά! Η πρώτη σας δοκιμή είναι γεγονός. Συνεχίζουμε σταθερά. 🚀

Στις κάρτες με όνομα Challenge – Password και Challenge Flow, δεν χρειάζεται να αγχώνεστε. 🧘‍♀️ Η διαδικασία είναι εξίσου απλή. 🙏

• Στην Challenge – Password, στο κενό πεδίο πληκτρολογείτε τον κωδικό που εμφανίζεται δίπλα από το όνομα της κάρτας (π.χ. Secret!33).
• Στην κάρτα Challenge Flow, απλώς επιλέγετε το κουμπί Yes.

Επιβεβαίωση Επιτυχών Δοκιμών #

Βεβαιωθείτε ότι όλα πήγαν ΤΕΛΕΙΑ – Είστε έτοιμοι! #

1. Στο Dashboard του Cardlink, ανοίξτε την εφαρμογή σας
2. Δείτε το πεδίο “Primary VPOS Transactions Test Case Progress Results”
3. Αν το “Test Case Status” λέει Passed, όλα πήγαν καλά
   🚨 Αν όχι: Ξανά ελέγξτε τα βήματα και επαναλάβετε τις συναλλαγές

Ενημέρωση Cardlink για Ολοκλήρωση Δοκιμών #

Επικοινωνία με την Cardlink #

🔑 Τι κάνετε εδώ: Ενημερώνετε επίσημα την Cardlink ότι ολοκληρώσατε με επιτυχία τις απαιτούμενες δοκιμές, ώστε να ζητήσετε την ενεργοποίηση του κανονικού (παραγωγικού) περιβάλλοντος. Με αυτό το βήμα, ετοιμάζετε το σύστημα πληρωμών σας για πραγματικές συναλλαγές με πελάτες.

🚨Προσοχή: Πριν ειδοποιήσετε την Cardlink ότι ολοκληρώθηκαν οι δοκιμές, βεβαιωθείτε ότι:

• Αρχικά πρέπει, η σελίδα Όροι & Προϋποθέσεις είναι δημοσιευμένη και περιλαμβάνει όλες τις πληροφορίες που ζητά η τράπεζα
• Έχετε προσθέσει τα λογότυπα των τραπεζικών καρτών (Visa, Mastercard κ.λπ.) στο footer της ιστοσελίδας

Η τράπεζα θα ελέγξει αυτά τα στοιχεία πριν σας στείλει τα στοιχεία για το παραγωγικό περιβάλλον και αν κάτι λείπει, θα σας ζητήσει να το διορθώσετε.

1. Στο Dashboard του Cardlink, πατήστε “Test Completed”
2. Συμπληρώστε το ΑΦΜ σας (π.χ. EL0000000)
3. Τέλος, ενημερώστε την Cardlink ότι ολοκληρώθηκαν οι δοκιμές και ζητήστε τα παραγωγικά credentials

🚀 Συγχαρητήρια! 🎉 Αυτό ήταν το προτελευταίο βήμα! Όταν έχετε τα credentials, προχωράτε στο τελευταίο βήμα. 🚀

Τελική Δοκιμή στο Παραγωγικό Περιβάλλον #

Ώρα για την πρώτη σας ΠΡΑΓΜΑΤΙΚΗ συναλλαγή #

1. Μόλις λάβετε τα παραγωγικά credentials, επιστρέψτε στο site
2. Μεταβείτε στο Gateway Settings > Alphabank
3. Απενεργοποιήστε το “Enable Test Environment”
4. Στη συνέχεια, αντικαταστήστε το Merchant ID και Secret με τα νέα στοιχεία
5. Πηγαίνετε στο προϊόν “Test” και κάντε μια κράτηση με πραγματική κάρτα
6. Τέλος, διαγράψτε το προϊόν “Test”.

💡 TIP : Αν στήνετε το σύστημα για άλλον, ενημερώστε τον ότι το site είναι πλέον έτοιμο να δέχεται πληρωμές με κάρτα.

🎉 🎊 Τέλος! Έχετε ολοκληρώσει όλη τη διαδικασία!! 🎉 🎊