Το επόμενο βήμα για την επικοινωνία με το POS, είναι να στείλουμε το ΑΡΧΕΙΟ 2. Το αρχείο αυτό, στέλνει την πληρωμή στο επιλεγμένο POS.



ΔΟΜΗ ΑΡΧΕΙΟΥ

Το αρχείο διεπαφής, πρέπει να περιέχει τα πεδία το ένα κάτω από το άλλο.

Η σύνταξη των πεδίων είναι <πεδίο>:<τιμή>. Για παράδειγμα, issuerVatNumber:555777003


TEMPLATE ΑΡΧΕΙΟΥ ΔΙΕΠΑΦΗΣ

method:

issuerVatNumber:

clientID:

secretKey:

sessionID:

terminalID:

cashRegisterID:

amount:

merchantText:

customerText:

instalments:

tipAmount:

testEnv:


Τα πεδία του αρχείου διεπαφής για την Αποστολή Πληρωμών

Τα πεδία με πράσινο χρώμα αφορούν τα πεδία που προστέθηκαν στις τελευταίες αλλαγές της διεπαφής

ΠΕΔΙΟ

ΔΟΜΗ/ΕΠΕΞΗΓΗΣΗ

ΥΠΟΧΡΕΩΤΙΚΟ

method

52

ΝΑΙ

issuerVatNumber

ΑΦΜ ΟΝΤΟΤΗΤΑΣ ΠΟΥ ΣΤΕΛΝΕΙ ΤΗΝ ΠΛΗΡΩΜΗ

ΝΑΙ

clientID

Κείμενο Client ID του API της VivaWallet

ΝΑΙ

secretKey

Κείμενο Secret του API της VivaWallet

ΝΑΙ

sessionID

ΜΟΝΑΔΙΚΟΣ ΑΡΙΘΜΟΣ ΣΥΝΕΔΡΙΑΣ.

ΕΛΕΥΘΕΡΟ ΚΕΙΜΕΝΟ

ΠΡΕΠΕΙ ΝΑ ΕΙΝΑΙ ΜΟΝΑΔΙΚΟ ΣΕ ΚΑΘΕ ΠΕΡΙΠΤΩΣΗ ΚΑΙ ΝΑ ΜΗΝ ΣΤΑΛΘΕΙ ΠΟΤΕ ΞΑΝΑ ΤΟ ΙΔΙΟ sessionID.

ΝΑΙ

terminalID

ΑΡΙΘΜΟΣ ID ΤΕΡΜΑΤΙΚΟΥ. ΤΟΝ ID ΤΕΡΜΑΤΙΚΟΥ ΤΟΝ ΒΡΙΣΚΟΥΜΕ ΑΠΟ ΤΟ ΑΡΧΕΙΟ 1.

ΝΑΙ

cashRegisterID

ΑΡΙΘΜΟΣ ΦΗΜ, ΠΧ DLD99999999.

ΕΛΕΥΘΕΡΟ ΚΕΙΜΕΝΟ

ΓΙΑ ΤΟ ΔΟΚΙΜΑΣΤΙΚΟ ΠΕΡΙΒΑΛΛΟΝ ΚΑΙ ΜΕΧΡΙ ΝΑ ΔΙΕΥΚΡΙΝΙΣΕΙ Η ΑΑΔΕ, ΑΝ ΔΕΝ ΥΠΑΡΧΕΙ ΦΗΜ, ΤΟΤΕ ΒΑΖΟΥΜΕ ΥΠΟΧΡΕΩΤΙΚΑ ΚΑΠΟΙΟ ΚΕΙΜΕΝΟ.

ΝΑΙ

amount

ΠΟΣΟ ΧΡΕΩΣΗΣ ΣΕ POS ΣΕ ΕΥΡΩ

ΝΑΙ

merchantText

ΑΝΑΓΝΩΡΙΣΤΙΚΟ ΚΕΙΜΕΝΟ ΣΥΝΑΛΛΑΓΗΣ ΕΜΠΟΡΟΥ

ΝΑΙ

customerText

ΑΝΑΓΝΩΡΙΣΤΙΚΟ ΚΕΙΜΕΝΟ ΣΥΝΑΛΛΑΓΗΣ ΠΕΛΑΤΗ

ΝΑΙ

instalments

ΜΕΓΙΣΤΟΣ ΑΡΙΘΜΟΣ ΔΟΣΕΩΝ

ΝΑΙ

tipAmount

ΠΟΣΟ ΦΙΛΟΔΩΡΗΜΑΤΟΣ ΣΕ ΕΥΡΩ

ΝΑΙ

provData

ΥΠΟΧΡΕΩΤΙΚΟ ΜΟΝΟ ΓΙΑ ΣΥΝΑΛΛΑΓΕΣ ΜΕΣΩ ΠΑΡΟΧΟΥ

ΔΕΔΟΜΕΝΑ ΠΛΗΡΩΜΗΣ POS ΠΑΡΟΧΟΥ

ΟΧΙ

provSign

ΥΠΟΧΡΕΩΤΙΚΟ ΜΟΝΟ ΓΙΑ ΣΥΝΑΛΛΑΓΕΣ ΜΕΣΩ ΠΑΡΟΧΟΥ

ΥΠΟΓΡΑΦΗ ΠΑΡΟΧΟΥ

ΟΧΙ

provAuthor

ΥΠΟΧΡΕΩΤΙΚΟ ΜΟΝΟ ΓΙΑ ΣΥΝΑΛΛΑΓΕΣ ΜΕΣΩ ΠΑΡΟΧΟΥ

ΚΩΔΙΚΟΣ ΠΑΡΟΧΟΥ

ΟΧΙ

testEnv

true/false - ΔΟΚΙΜΑΣΤΙΚΟ ΠΕΡΙΒΑΛΛΟΝ

ΝΑΙ


Παράδειγμα διεπαφής εύρεσης αποστολής πληρωμής POS (ΧΩΡΙΣ πάροχο)

method:52

issuerVatNumber:555777040

clientID:xxxxxxxxx.vivapayments.com

secretKey:yyyyyyyyyyyyyyyyyyyyyyyyy

sessionID:sessionXXXX-YYYY-ZZZZ_customSession

terminalID:123456

cashRegisterID:DLD99999999

amount:124

merchantText:payment for invoice XXXXX

customerText:payment for invoice XXXXX

instalments:12

tipAmount:0

testEnv:true


Παράδειγμα διεπαφής εύρεσης αποστολής πληρωμής POS (ΜΕ πάροχο)

method:52

issuerVatNumber:555777040

clientID:xxxxxxxxx.vivapayments.com

secretKey:yyyyyyyyyyyyyyyyyyyyyyyyy

sessionID:sessionXXXX-YYYY-ZZZZ_customSession

terminalID:123456

amount:124

merchantText:payment for invoice XXXXX

customerText:payment for invoice XXXXX

instalments:12

tipAmount:0

provData:97E85C464131D8C5E7B9E17B06A340F3790120E4;;20240621140201;12400;10000;0;12400;16000000

provSign:MEUCIQDFMMJGUjVbW75deTnohM4fbm0oukH5dyGz1b4x1AI6NgIgVESSr4nYADP0rHdLpO1dukZBN10VPbOZvqET/1dzAt9=

provAuthor:000

testEnv:true


ΕΠΙΣΤΡΕΦΟΜΕΝΟ ΑΡΧΕΙΟ

Το επιστρεφόμενο αρχείο θα περιέχει μήνυμα επαλήθευσης ότι το ποσό στάλθηκε στο POS ή όχι.

Πιθανά μηνύματα επιστροφής:

200 - The transaction was sent to the POS

999 - The transaction failed to be sent to the POS


Η ονομασία του επιστρεφόμενου αρχείου, είναι πάντα viva52.txt.


Τα επιστρεφόμενα αρχεία viva αποθηκεύονται στη διαδρομή <ΦΑΚΕΛΟΣ ΥΠΟΓΡΑΦΩΝ>/VivaWallet/.