Σκοπός:

Σε αυτή τη μελέτη περιγράφονται οι απαραίτητες ρυθμίσεις ώστε η Pegasus Web App εφαρμογή σας να επικοινωνήσει με τα POS της Cardlink, προκειμένου να δέχεται πληρωμές μέσω κάρτας κατά την καταχώρηση των παραστατικών.

Ρυθμίσεις Viva Wallet

Γενικές

1. Κάνετε login στον Viva Wallet λογαριασμό σας και στη συνέχεια, κλικ στο μενού κάτω αριστερά [SETTINGS->API ACCESS]

Στο tab [General] και στην υποενότητα [Access Credentials], καταγράφετε το [Merchant ID] και το [API Key].

2. Στην ίδια επιλογή και στην υποενότητα [POS APIs Credentials], κάνετε κλικ στο button [Generate a pair of credentials]

3. Στο νέο παράθυρο που εμφανίζεται, καταγράφετε τα [Client ID] και [Client Secret] που θα παραχθούν.

ΠΡΟΣΟΧΗ: Το client secret δεν μπορεί να επανεμφανιστεί. Αν το ξεχάσετε, θα πρέπει να δημιουργήσετε ένα νέο με κλικ στο σχετικό button.

Webhooks

1. Στο μενού [SETTINGS->API ACCESS], κάνετε κλικ στο tab [Webhooks] και στη συνέχεια, στο link [Create Webhook].

2. Στο νέο παράθυρο που εμφανίζεται, συμπληρώνετε τα εξής:

1. URL: συμπληρώνετε ένα url που θα δημιουργηθεί από την συνένωση των παρακάτω:
   1. Το url της εφαρμογής σας πχ https://mywebapp.pegcloud.io
   2. /pegasus_cloud_app/pos00_02/viva_webhook.php?pos00_01=
   3. Το ΜΚ της συσκευής POS που θα δημιουργήσετε παρακάτω(βλ Ρυθμίσεις Πήγασου->Συσκευές POS) πχ 3000001

Τελικό αποτέλεσμα: https://mywebapp.pegcloud.io/pegasus_cloud_app/pos00_02/viva_webhook.php?pos00_01=3000001

Σημείωση: για να ελέγξετε την ορθότητα του URL που καταχωρήσατε, μπορείτε να κάνετε κλικ στο [Verify]. Εφόσον το URL είναι αποδεκτό από τη Viva, θα εμφανιστεί σχετικό μήνυμα.

2. Active: το τσεκάρετε

3. Event Type: Transaction Payment Created

Eπαναμβάνετε τα βήματα δημιουργώντας άλλο ένα webhook με τα ίδια στοιχεία, με τη διαφορά ότι στο πεδίο [Event Type] θα επιλέξετε [Transaction Failed]

Σημείωση: μπορείτε να δείτε τις αντίστοιχες οδηγίες της Viva Wallet στα links:

• https://developer.vivawallet.com/getting-started/find-your-account-credentials/merchant-id-and-api-key/
• https://developer.vivawallet.com/getting-started/find-your-account-credentials/pos-apis-credentials/
• https://developer.vivawallet.com/webhooks-for-payments/

Ρυθμίσεις Πήγασου

Συσκευές POS

1. Στην επιλογή [Toolbox->Εργαλεία Παραμετροποίησης->POS Πληρωμών->Συσκευές POS] καταχωρείτε μια νέα εγγραφή.
2. Στην οθόνη που εμφανίζεται, καταχωρείτε τα εξής(μεταξύ άλλων):

• Τύπος: Viva Wallet

Όλα τα παρακάτω, τα παίρνετε από τον Viva Wallet λογαριασμό σας και τα καταχωρείτε ανάλογα:

• Merchant ID
• API Key
• Client ID
• Client Secret

    3. Κάνετε κλικ στο button [Εύρεση Συσκευών POS]. Εφόσον έχετε καταχωρήσει σωστά τα στοιχεία, η επιλογή [ID συσκευής POS] συμπληρώνεται αυτόματα.

Σημείωση: μπορείτε να επαναλάβετε τη διαδικασία εφόσον διαθέτετε παραπάνω από ένα POS.

Ρυθμίσεις POS

1. Στην επιλογή [Toolbox->Εργαλεία Παραμετροποίησης->POS Πληρωμών->Ρυθμίσεις POS] καταχωρείτε μια νέα εγγραφή.
2. Στην οθόνη που εμφανίζεται, καταχωρείτε τα εξής:
1. Συσκευή POS: επιλέγετε αυτή που δημιουργήσατε προηγουμένως
2. Τρόπος Είσπραξης: η εφαρμογή σας εμφανίζει αυτόματα μόνο τους τρ.είσπραξης χωρίς ΚΚ λογιστηρίου, καθώς αυτός ο περιορισμός είναι υποχρεωτικός. Ως εκ τούτου, προτείνουμε να αντιγράψετε τον standard τρόπο είσπραξης [99 - Επι Πιστώσει] και να δημιουργήσετε έναν νέο με περιγραφή πχ [πληρωμή με Viva Wallet]
3. Τερματικό: επιλέγετε το τερματικό για το οποίο θέλετε να ισχύει η συγκεκριμένη ρύθμιση
4. ΚΚ Λογιστηρίου: 1001 - είσπραξη από πελάτη(πιστωτική)

Σημείωση: μπορείτε να δημιουργήσετε έναν νέο ΚΚ λογιστηρίου, αντιγράφοντας τον παραπάνω.