Εάν χρειαστεί, μπορούμε να αντλήσουμε όλα τα στοιχεία οποιασδήποτε συναλλαγής γνωρίζουμε το sessionID. Η αναζήτηση αυτή μπορεί να χρησιμοποιηθεί εάν για τον οποιονδήποτε λόγο χρειαζόμαστε περισσότερη πληροφόρηση.

Για παράδειγμα, σε ορισμένες αποστολές στα myDATA, απαιτείται ο αριθμός συναλλαγής POS (transactionID). Τον αριθμό αυτό, τον βρίσκουμε χρησιμοποιώντας αυτή τη διεπαφή.



ΔΟΜΗ ΑΡΧΕΙΟΥ

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

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


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

method:

issuerVatNumber:

clientID:

secretKey:

sessionID:

testEnv:


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

ΠΕΔΙΟ

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

ΥΠΟΧΡΕΩΤΙΚΟ

method

54

ΝΑΙ

issuerVatNumber

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

ΝΑΙ

clientID

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

ΝΑΙ

secretKey

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

ΝΑΙ

sessionID

Ο μοναδικός sessionID που στάλθηκε με το ΑΡΧΕΙΟ 2 που είδαμε στο προηγούμενο βήμα.

ΝΑΙ

testEnv

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

ΝΑΙ


Παράδειγμα διεπαφής εύρεσης διαθέσιμων POS

method:54

issuerVatNumber:555777040

clientID:xxxxxxxxx.vivapayments.com

secretKey:yyyyyyyyyyyyyyyyyyyyyyyyy

sessionID:sessionID_From_ΑΡΧΕΙΟ_2

testEnv:true


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

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

Ενδεικτικό μήνυμα μίας επιτυχημένης συναλλαγής

sessionId:sessionXXXX-YYYY-ZZZZ_customSession

terminalId:123456

cashRegisterId:DLD99999999

amount:12400     [ΤΟ ΠΕΔΙΟ ΕΠΙΣΤΡΕΦΕΤΑΙ ΧΩΡΙΣ ΔΕΚΑΔΙΚΗ ΑΝΑΛΥΣΗ. ΤΟ ΠΟΣΟ ΑΥΤΟ ΣΗΜΑΙΝΕΙ 124,00]

currencyCode:978

merchantReference:payment for invoice XXXXX

customerTrns:payment for invoice XXXXX

tipAmount:0

success:true

eventId:0

authorizationId:123456

transactionId:12345a6b-7890-1cd2-3e34-567f8901g2hi     [ΤΟ ID ΑΥΤΟ ΧΡΕΙΑΖΟΝΤΑΙ ΤΑ MYDATA]

transactionTypeId:5

retrievalReferenceNumber:112345678901

panEntryMode:07

applicationLabel:Credit Mastercard

primaryAccountNumberMasked:123456******3456

transactionDateTime:2023-12-29T16:13:59.034000+00:00

abortOperation:false

abortAckTime:null

abortSuccess:false

loyaltyInfo:null

verificationMethod:CONTACTLESS - ONLINE PIN

tid:123456

shortOrderCode:1234567890

installments:0

message:Transaction successful

preauth:false

referenceNumber:123456

orderCode:1123456789012345


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


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