Mετάβαση στο κύριο περιεχόμενο

Οδηγός ενσωμάτωσης Smart Checkout

Το Smart Checkout της Viva.com σάς επιτρέπει να δέχεστε online πληρωμές μέσω μιας φιλοξενούμενης σελίδας ολοκλήρωσης πληρωμής.

Αυτός ο οδηγός εξηγεί τα βασικά βήματα για την ενσωμάτωση του Smart Checkout στον ιστότοπο ή την εφαρμογή σας, από τη ρύθμιση του Viva.com λογαριασμού σας και της πηγής πληρωμών έως την ανακατεύθυνση των πελατών και την επαλήθευση του αποτελέσματος της πληρωμής.

1. Επιλέξτε το περιβάλλον Viva.com

Η Viva.com παρέχει δύο περιβάλλοντα. Βεβαιωθείτε ότι χρησιμοποιείτε το περιβάλλον που αντιστοιχεί σε αυτό που θέλετε να κάνετε.

Περιβάλλον

Χρησιμοποιήστε το για

Ξεκινήστε

Παραγωγή

Αποδοχή πραγματικών πληρωμών

Demo

Δοκιμή της ενσωμάτωσής σας και δοκιμαστικές πληρωμές

Βεβαιωθείτε ότι εργάζεστε στο σωστό περιβάλλον κατά τη ρύθμιση και τη δοκιμή της ενσωμάτωσής σας.


2. Δημιουργήστε μια πηγή online πληρωμών

Μια πηγή πληρωμών περιλαμβάνει τις ρυθμίσεις που χρησιμοποιεί η Viva.com για πληρωμές που πραγματοποιούνται μέσω του ιστοτόπου ή της εφαρμογής σας.

Κατά τη ρύθμιση της πηγής πληρωμών, διαμορφώστε το domain σας και τα URL στα οποία θα πρέπει να επιστρέφουν οι πελάτες μετά την ολοκλήρωση της διαδικασίας πληρωμής.

Για παράδειγμα:

  • μια σελίδα επιτυχίας, όπως «Ευχαριστούμε για την παραγγελία σας»

  • μια σελίδα αποτυχίας, όπως «Παρουσιάστηκε πρόβλημα με την πληρωμή σας»

Για να δημιουργήσετε μια πηγή πληρωμών για online πληρωμές, μεταβείτε στις Πωλήσεις > Online Πληρωμές στον πίνακα ελέγχου της Viva.com.

Αφού δημιουργήσετε την πηγή πληρωμών, αποθηκεύστε τον 4ψήφιο κωδικό πηγής. Θα χρειαστείτε αυτόν τον κωδικό κατά τη διαμόρφωση της ενσωμάτωσής σας.

Παράδειγμα ρύθμισης πηγής πληρωμών με κωδικό 2861

Για αναλυτικές οδηγίες ρύθμισης, ανατρέξτε στην ενότητα Πηγές για Οnline πληρωμές | Viva.com Support.


3. Ενσωματώστε το Smart Checkout

Υπάρχουν τρία βασικά βήματα για την ενσωμάτωση του Smart Checkout:

Βήμα 1: Δημιουργήστε μια εντολή πληρωμής

Πριν ζητήσετε μια πληρωμή από έναν πελάτη, δημιουργήστε μια εντολή πληρωμής.

Σε κάθε εντολή πληρωμής εκχωρείται ένα μοναδικό 16ψήφιο ID, το οποίο ονομάζεται orderCode.

Δημιουργήστε την εντολή πληρωμής από τον server σας χρησιμοποιώντας το Create Payment Order API και, στη συνέχεια, μεταβιβάστε το orderCode στον ιστότοπο ή την εφαρμογή σας.

Για τις παραμέτρους του API και λεπτομέρειες σχετικά με την υλοποίηση, επισκεφθείτε το Viva.com Developer Portal. Στο αριστερό μενού, επιλέξτε APIs for payments, στη συνέχεια Payment API. Στην ενότητα Payments, επιλέξτε Create payment order.

Βήμα 2: Ανακατευθύνετε τον πελάτη στο Smart Checkout

Αφού δημιουργήσετε την εντολή πληρωμής, ανακατευθύνετε τον πελάτη στο Smart Checkout. Στη συνέχεια, ο πελάτης μπορεί να εισαγάγει τα στοιχεία πληρωμής του και να ολοκληρώσει τη διαδικασία πληρωμής στη σελίδα Smart Checkout.

Βήμα 3: Διαχειριστείτε την επιστροφή του πελάτη και επαληθεύστε το αποτέλεσμα της πληρωμής

Μετά τη διαδικασία πληρωμής, ο πελάτης ανακατευθύνεται στο URL που έχει διαμορφωθεί για το αντίστοιχο αποτέλεσμα:

  • URL Επιτυχημένης συναλλαγής για επιτυχημένες πληρωμές

  • URL Αποτυχημένης συναλλαγής για αποτυχημένες πληρωμές

Μπορείτε να διαμορφώσετε αυτά τα URL στον πίνακα ελέγχου της Viva.com στην ενότητα Πωλήσεις > Online Πληρωμές > Websites / Apps.

Επαληθεύστε το αποτέλεσμα της πληρωμής

Επαληθεύστε την κατάσταση της συναλλαγής στο σύστημά σας χρησιμοποιώντας τις πληροφορίες πληρωμής που επιστρέφονται από τη Viva.com. Οι πληροφορίες συναλλαγής που χρησιμοποιούνται για την επαλήθευση περιλαμβάνουν:

  • Amount

  • transactionId

  • statusId

Η Viva.com παρέχει τις ακόλουθες μεθόδους για τον έλεγχο του αποτελέσματος της πληρωμής.

Webhooks

Τα Webhooks επιτρέπουν στο σύστημά σας να λαμβάνει ειδοποιήσεις σχετικά με την επιτυχία ή την αποτυχία μιας πληρωμής και υποστηρίζουν τόσο σύγχρονες όσο και ασύγχρονες μεθόδους πληρωμής.

Για λεπτομέρειες σχετικά με την υλοποίηση, τις παραμέτρους συμβάντων και ενδεικτικά payloads, επισκεφθείτε το Viva.com Developer Portal και επιλέξτε Webhooks For Payments από το μενού.

Retrieve Transaction API

Μπορείτε επίσης να ανακτήσετε πληροφορίες συναλλαγής χρησιμοποιώντας το Retrieve Transaction API. Για τις παραμέτρους του API και λεπτομέρειες σχετικά με την υλοποίηση, επισκεφθείτε το Viva.com Developer Portal. Στο αριστερό μενού, επιλέξτε APIs for payments, στη συνέχεια Payment API. Στην ενότητα Transactions, επιλέξτε Retrieve transaction.


Προαιρετικές ρυθμίσεις Smart Checkout

Μπορείτε επίσης να διαμορφώσετε πρόσθετες ρυθμίσεις Smart Checkout ανάλογα με τις ανάγκες της ενσωμάτωσής σας.

Εμφανίστε το λογότυπο της εταιρείας σας

Μπορείτε να προσθέσετε το λογότυπο της εταιρείας σας στο Smart Checkout μέσω των ρυθμίσεων της πηγής πληρωμών. Για οδηγίες, επισκεφθείτε το Viva.com Developer Portal, μεταβείτε στην ενότητα Tutorials, επιλέξτε Smart Checkout Configuration και, στη συνέχεια, κάντε κλικ στο Add your brand logo.

Βεβαιωθείτε ότι ανεβάζετε ένα ευκρινές λογότυπο κατάλληλου μεγέθους για βέλτιστη εμφάνιση.

Εμφανίστε ένα κουμπί Cancel

Μπορείτε να διαμορφώσετε ένα κουμπί Cancel στις ρυθμίσεις για προχωρημένους της πηγής πληρωμών. Έτσι, οι πελάτες έχουν τη δυνατότητα να ακυρώσουν την παραγγελία τους.

Το κουμπί Cancel υποστηρίζεται για άμεσες ενσωματώσεις Smart Checkout και plugins για Shopify και PrestaShop.

Μπορείτε επίσης να διαμορφώσετε webhooks για να λαμβάνετε ειδοποιήσεις σχετικά με συμβάντα ακύρωσης παραγγελιών. Επισκεφθείτε το Viva.com Developer Portal, επιλέξτε Webhooks For Payments και στη συνέχεια Order Updated για περισσότερες πληροφορίες.


Πρόσθετες επιλογές πληρωμής

Το Smart Checkout υποστηρίζει επίσης πρόσθετες διαμορφώσεις πληρωμών, όπως:

  • Επαναλαμβανόμενες πληρωμές: Ο έμπορος ξεκινά αυτόματα χρεώσεις σύμφωνα με ένα προκαθορισμένο χρονοδιάγραμμα μετά την πρώτη πληρωμή.

  • Προεγκρίσεις: Ένα ποσό δεσμεύεται και η μεταφορά των χρημάτων πραγματοποιείται αργότερα.

Για τεχνικές λεπτομέρειες σχετικά με την υλοποίηση και άλλες διαθέσιμες διαμορφώσεις του Smart Checkout, επισκεφθείτε το Viva.com developer portal.

Χρειάζεστε ακόμη βοήθεια; Η ομάδα μας είναι εδώ για να σας υποστηρίξει. Επικοινωνήστε μαζί μας μέσω της επιλογής Μιλήστε μαζί μας στον Viva.com λογαριασμό σας.

Απαντήθηκε η ερώτησή σας;