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

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

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

Εδώ θα δεις βήμα-βήμα:

• Πώς να φτιάξεις λογαριασμό στην Cardlink.
• Πώς να κάνεις δοκιμές με εικονικές κάρτες.
• Πώς να ζητήσεις τα στοιχεία για live πληρωμές.
• Και πώς να κάνεις την πρώτη σου συναλλαγή σε πραγματικό περιβάλλον.

Δεν χρειάζεσαι τεχνικές γνώσεις — ακολούθα απλώς τα βήματα. 😎

Τι χρειάζεσαι πριν ξεκινήσεις #

Χρειάζεται να έχεις:

• Έναν λογαριασμό στο developer.cardlink.gr (αν δεν έχεις, μην ανησυχείς — θα τον φτιάξουμε μαζί).
• Πρόσβαση στο διαχειριστικό της ιστοσελίδας σου (admin panel).

💡 TIP: Άνοιξε δύο καρτέλες στον browser σου:

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

Έτσι θα μπορείς να κάνεις εύκολα copy-paste μεταξύ των δύο. 😉

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

🔑 Τι περιλαμβάνει αυτό το βήμα;
Φτιάχνεις λογαριασμό στο Cardlink — είναι το πρώτο βήμα.

1. Πήγαινε στη σελίδα: developer.cardlink.gr.
2. Πάτα Register για να δημιουργήσεις λογαριασμό (ή Login αν έχεις ήδη)
3. Μετά την εγγραφή, πήγαινε στο email σου και ενεργοποίησε τον λογαριασμό πατώντας το link που θα σου στείλουν.

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

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

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

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

1. Συνδέσου στον λογαριασμό σου στο Cardlink.
2. Πάτα Create a new App.
3. Συμπλήρωσε τα στοιχεία:

• 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 της ιστοσελίδας σου (π.χ. info@mysite.gr).
4. Τέλος, μόλις τα συμπληρώσεις, πάτα Save Changes.

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

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

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

🔑 Τι κάνεις εδώ;
Ήρθε η ώρα να δώσεις στο site σου τις πληροφορίες που χρειάζεται για να “μιλάει” με την Cardlink.

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

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

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

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

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

Στο ίδιο σημείο (Gateway Settings → Alpha Bank), θα δεις μερικά έξτρα πεδία. Γέμισέ τα έτσι:

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 είναι ΟΚ.

Βήμα 1: Φτιάξε ένα “δοκιμαστικό προϊόν” #

Πήγαινε στο admin panel του site σου, εκεί που προσθέτεις διαθεσιμότητες (Accommodation, Travel κ.λπ.).

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

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

📌 Σημείωση: Η τιμή δεν πρέπει να ξεπερνάει τα 0.10 € και πρέπει να περιλαμβάνει τελεία ” . ” .

Βήμα 2: Κάνε την κράτηση με δοκιμαστική κάρτα #

1. Αρχικά, κάνε κράτηση για το “Test” και επίλεξε πληρωμή με κάρτα.
2. Πήγαινε στο Cardlink → Starter Guide → Test Cards.
3. Εκεί θα βρεις δοκιμαστικές κάρτες. Χρησιμοποίησε 2–3 Mastercard και 2–3 Visa από τη λίστα.
4. Συμπλήρωσε οποιοδήποτε:
   • Όνομα κατόχου
   • Ημερομηνία λήξης
   • CVV

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

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

Βήμα 3: Τεστάρουμε και τις “Challenge” κάρτες #

Μην αγχώνεσαι, είναι πιο εύκολο απ’ όσο φαίνεται 🧘‍♀️

• 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 ότι όλα πήγαν καλά στις δοκιμές, ώστε να σου δώσουν τα στοιχεία για το παραγωγικό περιβάλλον — δηλαδή να ξεκινήσεις να δέχεσαι κανονικές πληρωμές από πελάτες..

🚨Προσοχή: Πριν τους στείλεις μήνυμα, έλεγξε ότι:

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

⚠️ Η τράπεζα τα ελέγχει όλα αυτά πριν σου στείλει τα “παραγωγικά credentials”. Αν λείπει κάτι, θα σου το ζητήσουν.

✏️ Και τώρα… ενημέρωσε τους!

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

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

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

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

Μόλις πάρεις από την Cardlink τα παραγωγικά credentials, κάνε τα εξής:

1. Αρχικά, μπες στο site σου → Gateway Settings → Alpha Bank.
2. Απενεργοποίησε την επιλογή “Enable Test Environment”.
3. Αντικατέστησε τα παλιά στοιχεία Merchant ID και Secret
4. Πήγαινε στο προϊόν “Test” που είχες φτιάξει και κάνε μια πραγματική κράτηση με κανονική κάρτα.
5. Μόλις ολοκληρωθεί η πληρωμή, διέγραψε το προϊόν “Test”. Δεν το χρειάζεσαι πλέον.

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

🎉 🎊 Μπράβο σου! Ολοκλήρωσες ΟΛΗ τη διαδικασία!! 🎉 🎊