Web Service Manual Ver 1.0.6 El

Ιζηνξηθό Αιιαγώλ
Ηκεξνκελία Έθδνζε Αιιαγέο

01/07/2009 1.0 Αξρηθή έθδνζε
01/12/2009 1.0.1 Πξνζζήθε test cases ζηελ ελόηεηα 7
01/02/2010 1.0.2 Αιιαγή URL ηνπ Transaction Web Service (ελόηεηα 5)
Πξνζζήθε δπλαηόηεηαο ρξήζεο θάξηαο απνδείμεσλ (ελόηεηα
18/10/2011 1.0.3 5), δπλαηόηεηαο ρξέσζεο θαξηώλ American Express (ελόηεηα
5) θαη πξνζζήθε λέσλ test cases (ελόηεηα 7)
 Πξνζζήθε ηύπνπ θάξηαο “Maestro” θαη “UNKNOWN” (ελόηεηα
24/04/2013 1.0.4 5)
 Τπνζηήξημε δηαθόξσλ λνκηζκάησλ εθηόο από επξώ
Πξνζζήθε λένπ test case γηα ζπλαιιαγή ζε λόκηζκα USD (test
07/08/2013 1.0.5
case 15 ζηελ ελόηεηα 7)
28/04/2014 1.0.6  Τπνζηήξημε Discover θαξηώλ
 Πξνζζήθε λένπ test case γηα ζπλαιιαγή κε θάξηα Discover
(test case 13 ζηελ ελόηεηα 7)
Πεξηερόκελα
1. Δηζαγσγή 2
2. Γεληθή Αξρηηεθηνληθή 4
3. ΢ηνηρεία γηα ηε Γεκηνπξγία Test Account 5
4. Πηζηνπνίεζε Θαηόρνπ Θάξηαο («3d-secure») 6
5. Paycenter Transaction Web Service 14
6. Ρνή Δλεξγεηώλ Δθαξκνγήο Δπηρείξεζεο 30
7. Transaction Web Service Test Cases 34
8. Απαηηήζεηο Αζθάιεηαο 52
9. Υξήζε Δηθνληδίσλ 53
10. ΢πκβνπιέο 56
11. Implementation Checklist 58
Παξάξηεκα 1 61
Παξάξηεκα 2 67
Γισζζάξη 68
Πειραιώς Paycenter 1
1. Δηζαγσγή
Ζ ιύζε «Web Service» ηεο ππεξεζίαο «Πεηξαηώο Paycenter» ηεο Σξάπεδαο

Πεηξαηώο, ρξεζηκνπνηείηαη γηα ηελ online επηθνηλσλία ηνπ ζπζηήκαηνο κηαο
επηρείξεζεο κε ηελ ππεξεζία «Πεηξαηώο Paycenter» (server-to-server επηθνηλσλία)
πξνθεηκέλνπ λα δνζεί ε δπλαηόηεηα εθηέιεζεο ζπλαιιαγώλ κε θάξηα.
Σα ζηνηρεία ηεο ζπλαιιαγήο απνζηέιινληαη ζην ζύζηεκα ειεθηξνληθώλ πιεξσκώλ

ηεο ηξάπεδαο Πεηξαηώο («Πεηξαηώο Paycenter») κε ρξήζε ελόο SOAP Web
Service («Transaction Web Service»).
Δηδηθά γηα ηηο πεξηπηώζεηο on-line ζπλαιιαγώλ κέζσ site, πξνεγείηαη ε «δηαδηθαζία
πηζηνπνίεζεο θαηόρνπ θάξηαο» (πξσηόθνιιν «3D-Secure», ππεξεζίεο «Verified
by Visa» θαη «Mastercard SecureCode» ησλ νξγαληζκώλ Visa θαη Mastercard
αληίζηνηρα) πνπ πεξηγξάθεηαη ζε επόκελε ελόηεηα.
Οη θάξηεο πνπ ππνζηεξίδνληαη από ην «Πεηξαηώο Paycenter» είλαη νη εμήο:

 Visa θαη Mastercard πηζησηηθέο θάξηεο όισλ ησλ ηξαπεδώλ
 Visa ρξεσζηηθέο θάξηεο όισλ ησλ ηξαπεδώλ
 Maestro ρξεσζηηθέο θάξηεο (κόλν εθόζνλ πξνεγείηαη ε «3D-Secure»
δηαδηθαζία)
 Visa θαη MasterCard πξνπιεξσκέλεο θάξηεο όισλ ησλ ηξαπεδώλ
Δπίζεο, εθόζνλ ε ζπλεξγαζία κε ηελ επηρείξεζε πεξηιακβάλεη θαη Diners/Discover

ή/θαη American Express θάξηεο, ηόηε ππνζηεξίδνληαη θαη νη ελ ιόγσ θάξηεο.
Πξνζνρή!
Γηα λα ππνζηεξηρζνύλ Diners/Discover ή American Express θάξηεο, ζα
πξέπεη ε επηρείξεζε λα έξζεη ζε επαθή κε ηελ Σξάπεδα Πεηξαηώο γηα λα
ελεκεξσζεί γηα ηελ απαξαίηεηε εκπνξηθή δηαδηθαζία.
΢ηηο ελόηεηεο πνπ αθνινπζνύλ πεξηγξάθνληαη αλαιπηηθά πιεξνθνξίεο γηα ηα εμήο:
 Δλόηεηα 2  Γεληθή Αξρηηεθηνληθή:

Πεξηγξαθή ηεο γεληθήο αξρηηεθηνληθήο ηεο ιύζεο «Web Service».
 Δλόηεηα 3  ΢ηνηρεία γηα ηε Γεκηνπξγία Test Account:

Σα ζηνηρεία πνπ ρξεηάδεηαη λα ζηαινύλ ζηελ Σξάπεδα Πεηξαηώο ώζηε λα
δεκηνπξγεζεί δνθηκαζηηθόο ινγαξηαζκόο (test account) πξνθεηκέλνπ λα
πξαγκαηνπνηεζνύλ δνθηκαζηηθέο ζπλαιιαγέο.
 Δλόηεηα 4  Πηζηνπνίεζε Καηόρνπ Κάξηαο («3d-secure»):

Αλαθνξά ζηε δηαδηθαζία πηζηνπνίεζεο θαηόρνπ θάξηαο πνπ πξέπεη λα
πξαγκαηνπνηείηαη ζε on-line ζπλαιιαγέο κέζσ site (ρξήζε πιαηθόξκαο ηεο
Cardinal).
 Δλόηεηα 5  Paycenter Transaction Web Service:

Πεξηγξαθή ησλ παξακέηξσλ ηνπ «Transaction Web Service» πνπ
ρξεζηκνπνηείηαη γηα λα ζηαινύλ ηα ζηνηρεία κηαο ζπλαιιαγήο ζην «Πεηξαηώο
Paycenter».
 Δλόηεηα 6  Ρνή Δλεξγεηώλ Δθαξκνγήο Δπηρείξεζεο:
Παξνπζίαζε ζε κνξθή δηαγξάκκαηνο ηνπ αιγόξηζκνπ πνπ πξέπεη λα
πινπνηεζεί από ηελ εθαξκνγή ηεο επηρείξεζεο ώζηε λα εθηειεζηεί κία
ζπλαιιαγή.
 Δλόηεηα 7  Transaction Web service Test Cases:

Πεξηγξαθή ησλ test cases πνπ πξέπεη λα εθηειεζηνύλ ζηα πιαίζηα ησλ
δνθηκαζηηθώλ ζπλαιιαγώλ ηνπ Transaction Web Service.
 Δλόηεηα 8  Υξήζε Δηθνληδίσλ:

Αθνξά ζπζηήκαηα πνπ απνζηέιινπλ ζπλαιιαγέο κέζσ site.
Πεξηιακβάλεηαη πιηθό γηα ηα ππνρξεσηηθά θαη ηα πξναηξεηηθά εηθνλίδηα πνπ
πξέπεη λα αλαξηεζνύλ ζην site.
 Δλόηεηα 9  ΢πκβνπιέο:
΢πκβνπιέο θαη παξαηεξήζεηο γηα ζεκεία πνπ πξέπεη λα ιεθζνύλ ππόςε.
 Δλόηεηα 10  Implementation Checklist:

Ιίζηα ησλ ελεξγεηώλ πνπ πξέπεη λα εθηειεζηνύλ από ηνλ ηερληθό ππεύζπλν
ώζηε λα νινθιεξσζεί ε ζπλεξγαζία κε ηελ επηρείξεζε.
2. Γεληθή Αξρηηεθηνληθή
΢ην παξαθάησ δηάγξακκα απεηθνλίδεηαη ε γεληθή αξρηηεθηνληθή ηεο ππεξεζίαο

«Web Service» γηα on-line ζπλαιιαγέο πνπ πξαγκαηνπνηνύληαη από site
επηρεηξήζεσλ.
Διάγραμμα 1: Γενική αρτιηεκηονική
Γηα λα πξαγκαηνπνηεζεί κία ζπλαιιαγή κε θάξηα Visa, Mastercard ή Maestro, ην

ζύζηεκα ηεο επηρείξεζεο θαηαξρήλ επηθνηλσλεί κε ηελ πιαηθόξκα ηεο Cardinal
(βήκαηα 1, 2) πξνθεηκέλνπ λα γίλεη ε «δηαδηθαζία πηζηνπνίεζεο θαηόρνπ
θάξηαο» (πξσηόθνιιν «3d-secure», ππεξεζίεο «Verified by Visa» θαη
«Mastercard SecureCode» ησλ νξγαληζκώλ Visa θαη Mastercard αληίζηνηρα).
Σερληθέο πιεξνθνξίεο γηα ηε δηαδηθαζία απηή πεξηιακβάλνληαη ζηηο ηερληθέο
πξνδηαγξαθέο γηα ηε ρξήζε ηεο πιαηθόξκαο ηεο Cardinal πνπ δίλνληαη μερσξηζηά
από ηελ ηξάπεδα Πεηξαηώο (βι. θαη ελόηεηα 4). Γηα ζπλαιιαγέο κε άιιεο θάξηεο
(π.ρ. Diners/Discover ή American Express), δελ πξαγκαηνπνηείηαη ε δηαδηθαζία
πηζηνπνίεζεο θαηόρνπ θάξηαο. Δθόζνλ ην απνηέιεζκα ηεο πηζηνπνίεζεο ηνπ
θαηόρνπ είλαη ηέηνην πνπ επηηξέπεη ηελ εθηέιεζε ηεο ζπλαιιαγήο, ζηε ζπλέρεηα
ρξεζηκνπνηείηαη ην «Transaction Web Service» ηεο ηξάπεδαο Πεηξαηώο (βήκαηα
3, 4) ώζηε λα ζηαινύλ ηα ζηνηρεία ηεο ζπλαιιαγήο ζην ζύζηεκα ειεθηξνληθώλ
πιεξσκώλ ηεο ηξάπεδαο Πεηξαηώο («Πεηξαηώο Paycenter») θαη λα ιεθζεί ε
απάληεζε (βι. ελόηεηα 5).
Γηα ζπλαιιαγέο από ζπζηήκαηα όπνπ ηα ζηνηρεία ηεο θάξηαο δίλνληαη από ηνλ
θάηνρν ζε ηξίην πξόζσπν (π.ρ. ζηνλ agent ελόο Call Center) ή γίλνληαη κέζσ
πηζηνπνηεκέλνπ καγλεηηθνύ αλαγλώζηε («card present ζπλαιιαγέο» - ηα ζηνηρεία
ηεο θάξηαο δηαβάδνληαη από πηζηνπνηεκέλν καγλεηηθό αλαγλώζηε), δελ
πξαγκαηνπνηνύληαη ηα βήκαηα 1 θαη 2, αιιά απεπζείαο ζηέιλνληαη ηα ζηνηρεία ηεο
ζπλαιιαγήο ζην «Πεηξαηώο Paycenter» (βήκαηα 3,4 – βι. ελόηεηα 5).
3. ΢ηνηρεία γηα ηε Γεκηνπξγία Test Account
Οη πιεξνθνξίεο πνπ πξέπεη λα ζηαινύλ ζηελ Σξάπεδα Πεηξαηώο πξνθεηκέλνπ λα

δνζνύλ νη απαξαίηεηεο ηερληθέο πιεξνθνξίεο (test account) γηα λα γίλνπλ
δνθηκαζηηθέο ζπλαιιαγέο, είλαη νη εμήο (όιεο είλαη ππνρξεσηηθέο):
 ΢ηνηρεία ηερληθνύ ππεύζπλνπ:

 Ολνκ/πώλπκν ηερληθνύ ππεύζπλνπ
 Σειέθσλν επηθνηλσλίαο ηερληθνύ ππεύζπλνπ
 Email address ηερληθνύ ππεύζπλνπ
 Δηαηξία ζηελ νπνία αλήθεη ν ηερληθόο ππεύζπλνο
 ΢ηνηρεία επηρείξεζεο πνπ αλήθεη ην ζύζηεκα:

 Γηαθξηηηθόο ηίηινο επηρείξεζεο ζηελ νπνία αλήθεη ην ζύζηεκα
 ΑΦΚ επηρείξεζεο ζηελ νπνία αλήθεη ην ζύζηεκα
 Domain name ηνπ live site ηεο επηρείξεζεο (εθόζνλ νη ζπλαιιαγέο
ζα γίλνληαη από site)
 Σερληθά ζηνηρεία:
 Γιώζζα πξνγξακκαηηζκνύ: Ζ γιώζζα πξνγξακκαηηζκνύ
ρξεηάδεηαη γηα λα ζηαινύλ νη ηερληθέο πξνδηαγξαθέο γηα ηελ
πιαηθόξκα ηεο Cardinal ζηελ αληίζηνηρε γιώζζα (αθνξά
ζπζηήκαηα on-line πιεξσκώλ).
 IP address: Ζ IP address ηνπ server από ηνλ νπνίν ζα θαιείηαη ην
«Transaction Web Service» ηεο ηξάπεδαο Πεηξαηώο.
 Τπνζηήξημε δόζεσλ: Γειώλεηαη εάλ ζα ρξεζηκνπνηεζνύλ δόζεηο ή
όρη ζηηο δνθηκαζηηθέο ζπλαιιαγέο.
 Τπνζηήξημε θάξηαο απνδείμεσλ: Γειώλεηαη εάλ ζα γίλεη ρξήζε
ηεο θάξηαο απνδείμεσλ ζηηο δνθηκαζηηθέο ζπλαιιαγέο.
Σα ζηνηρεία ηνπ δνθηκαζηηθνύ ινγαξηαζκνύ (test account) πνπ δίλνληαη από ηελ
Σξάπεδα Πεηξαηώο εθόζνλ ζηαινύλ νη παξαπάλσ πιεξνθνξίεο, είλαη ηα εμήο:
 3d-secure test account (γηα ηε δηαδηθαζία πηζηνπνίεζεο θαηόρνπ

θάξηαο – κόλν γηα ζπζηήκαηα κε on-line ζπλαιιαγέο):
 ProcessorId
 MerchantId
 TransactionPwd
 Paycenter test account (γηα ηελ απνζηνιή ζπλαιιαγήο κέζσ ηνπ

«Transaction Web Service»):
 AcquirerID
 MerchantID
 PosID
 User
 Password
 ChannelType
Πιεξνθνξίεο γηα ηε ρξεζηκόηεηα απηώλ ησλ ζηνηρείσλ πεξηιακβάλνληαη ζηηο

ελόηεηεο πνπ αθνινπζνύλ.
4. Πηζηνπνίεζε Καηόρνπ Κάξηαο («3d-secure»)
΢ε on-line ζπλαιιαγέο αγνξάο ή πξνέγθξηζεο (βι. ελόηεηα 5 γηα ηνπο ηύπνπο

ζπλαιιαγώλ) θαη κόλν κε θάξηα Visa, Mastercard ή Maestro πνπ ζηέιλνληαη κέζσ
site, είλαη απαξαίηεην λα πξαγκαηνπνηείηαη θάζε θνξά ε δηαδηθαζία πηζηνπνίεζεο
θαηόρνπ θάξηαο (πξσηόθνιιν «3d-secure», ππεξεζίεο «Verified by Visa» θαη
«Mastercard SecureCode» ησλ νξγαληζκώλ Visa θαη Mastercard αληίζηνηρα). Ζ
δηαδηθαζία πξαγκαηνπνηείηαη κε ρξήζε εμεηδηθεπκέλεο πιαηθόξκαο ηεο Cardinal. Οη
ηερληθέο πξνδηαγξαθέο γηα ηε ρξήζε ηεο πιαηθόξκαο απηήο, δίλνληαη από ηελ
ηξάπεδα Πεηξαηώο ζηηο νπνίεο ππάξρνπλ όιεο νη απαξαίηεηεο ηερληθέο πιεξνθνξίεο.
Σν URL ζην νπνίν απνζηέιινληαη ηα κελύκαηα γηα ηε δηαδηθαζία πηζηνπνίεζεο,
θαίλεηαη παξαθάησ:
Γηα δνθηκαζηηθέο ζπλαιιαγέο ζηελ πιαηθόξκα ηεο Cardinal:

https://centineltest.cardinalcommerce.com/maps/txns.asp
Γηα πξαγκαηηθέο ζπλαιιαγέο ζηελ πιαηθόξκα ηεο Cardinal:

https://centinel.piraeusbank.fdsecure.com/maps/txns.asp
Πξνζνρή!
 Ζ πηζηνπνίεζε θαηόρνπ θάξηαο αθνξά κόλν ζπλαιιαγέο κε Visa,
Mastercard θαη Maestro.
 Σν λόκηζκα πνπ ρξεζηκνπνηείηαη ζηε 3D-Secure δηαδηθαζία

(παξάκεηξνο «Currency» ζην cmpi_lookup κήλπκα) πξέπεη λα
είλαη ίδην κε απηό πνπ ζα ρξεζηκνπνηεζεί ζην Transaction Web
Service.
 Ζ δηαδηθαζία πηζηνπνίεζεο πξνεγείηαη κόλν ζπλαιιαγώλ αγνξάο

ή πξνέγθξηζεο. ΢ε όιεο ηηο ππόινηπεο ζπλαιιαγέο (π.ρ.
αθπξώζεηο/αληηινγηζκνύο, νινθιήξσζε πξνέγθξηζεο θιπ), δε
ρξεζηκνπνηείηαη (βι. ελόηεηα 5 γηα ηνπο ηύπνπο ζπλαιιαγώλ).
 Γηα ζπλαιιαγέο πνπ γίλνληαη από ζπζηήκαηα όπνπ ν θάηνρνο δίλεη

ηα ζηνηρεία ηεο θάξηαο ηνπ ζε ηξίην πξόζσπν (π.ρ. ζηνλ agent
ελόο Call Center) ή γίλνληαη κε θπζηθή παξνπζία θάξηαο (δειαδή
ηα ζηνηρεία ηεο θάξηαο δηαβάδνληαη από πηζηνπνηεκέλν καγλεηηθό
αλαγλώζηε), δελ πξέπεη λα ρξεζηκνπνηείηαη ε δηαδηθαζία
πηζηνπνίεζεο θαηόρνπ θάξηαο.
΢ην documentation ηεο πιαηθόξκαο ηεο Cardinal θαη ζπγθεθξηκέλα ζην θεθάιαην
7 ηνπ document «Centinel.IntegrationGuide.PayerAuthentication.pdf»,
πεξηγξάθνληαη όια ηα πηζαλά cases πνπ κπνξνύλ λα ζπκβνύλ θαηά ηε δηαδηθαζία
ηεο πηζηνπνίεζεο θαη ηα νπνία είλαη ππνρξεσηηθό λα δνθηκαζηνύλ. Δθόζνλ
νινθιεξσζεί ε δηαδηθαζία ηεο πηζηνπνίεζεο, ην ζύζηεκα ηεο επηρείξεζεο εμεηάδεη
αλ ζα ζηείιεη ή όρη ζπλαιιαγή (αλάινγα κε ην απνηέιεζκα ηεο δηαδηθαζίαο
πηζηνπνίεζεο – βι. παξαθάησ ην ζρεηηθό πίλαθα) θαη θαιεί ην «Transaction Web
Service» (βι. ελόηεηα 5) ζηέιλνληαο ζηνηρεία γηα ηε ζπλαιιαγή. Κεηαμύ ησλ
δεδνκέλσλ πνπ ζηέιλνληαη, ηα ζηνηρεία ηνπ element «AuthInfo» πξνέξρνληαη
από ηε δηαδηθαζία πηζηνπνίεζεο (πξόθεηηαη γηα ηηο παξακέηξνπο ηνπ «Transaction
Web Service» κε νλόκαηα «Cavv», «Eci», «Xid», «Enrolled», «PAResStatus» θαη
«SignatureVerification»). Ηδηαίηεξα γηα ηηο παξακέηξνπο «Enrolled»,
«PAResStatus» θαη «SignatureVerification» πνπ είλαη complex type, ππάξρεη κηα
αληηζηνηρία κεηαμύ ησλ ηηκώλ πνπ επηζηξέθνληαη από ηα κελύκαηα ηεο δηαδηθαζίαο
πηζηνπνίεζεο («cmpi_lookup» θαη «cmpi_authenticate» κελύκαηα - βι.
documentation ηεο πιαηθόξκαο ηεο Cardinal) θαη ησλ αληίζηνηρσλ ηηκώλ πνπ
πξέπεη λα ρξεζηκνπνηεζνύλ ζην «Transaction Web Service». Ζ αληηζηνηρία απηή
θαίλεηαη παξαθάησ:
Παξάκεηξνο «Enrolled»
Σηκή ζην cmpi_lookup κήλπκα Σηκή ζην Transaction Web Service
Y Yes
N No
U Undefined
Παξάκεηξνο «PAResStatus»
Σηκή ζην cmpi_authenticate
Σηκή ζην Transaction Web Service
κήλπκα
Y Succeded
N Failed
A Attempted
U Unknown
Παξάκεηξνο «SignatureVerification»
Σηκή ζην cmpi_authenticate
Σηκή ζην Transaction Web Service
κήλπκα
Y Yes
N No
U Undefined
΢ηνλ πίλαθα πνπ αθνινπζεί, πεξηιακβάλνληαη νδεγίεο γηα ηηο ελέξγεηεο πνπ πξέπεη
λα πξαγκαηνπνηεί ην ζύζηεκα ηεο επηρείξεζεο γηα θαζέλα από ηα 21 cases ηεο
δηαδηθαζίαο πηζηνπνίεζεο (βι. documentation ηεο πιαηθόξκαο ηεο Cardinal,
θεθάιαην 7 ηνπ document
«Centinel.IntegrationGuide.PayerAuthentication.pdf»). Όπσο θαίλεηαη,
ππάξρνπλ πεξηπηώζεηο πνπ ην ζύζηεκα πξέπεη λα ζηείιεη ζπλαιιαγή ζην
«Πεηξαηώο Paycenter» (θαιώληαο ην «Transaction Web Service»), άιιεο
πεξηπηώζεηο πνπ δελ πξέπεη λα ζηείιεη ζπλαιιαγή θαη άιιεο πνπ είλαη απόθαζε
ηεο επηρείξεζεο αλ ζα ζηείιεη ή όρη ζπλαιιαγή. Ζ ηξίηε ζηήιε κε ηίηιν «Κάιπςε
από ακθηζβεηήζεηο», εκθαλίδεη εάλ ε επηρείξεζε είλαη θαιπκκέλε από
ακθηζβεηήζεηο θαηόρσλ θάξηαο. ΢πγθεθξηκέλα, εάλ ε επηρείξεζε ζηείιεη
ζπλαιιαγή θαη εγθξηζεί, δειώλεηαη ζηελ πεξίπησζε πνπ ν θάηνρνο ηεο θάξηαο
ακθηζβεηήζεη ηε ζπλαιιαγή ηζρπξηδόκελνο όηη δελ ήηαλ απηόο ν νπνίνο
πξαγκαηνπνίεζε ηε ζπλαιιαγή, εάλ ε επηρείξεζε είλαη θαιπκκέλε από ηελ
ακθηζβήηεζε ή όρη. Ζ πξνζηαζία απηή παξέρεηαη ιόγσ ηεο πινπνίεζεο θαη ρξήζεο
ηεο δηαδηθαζίαο πηζηνπνίεζεο θαηόρνπ θάξηαο.
Πξνζνρή!
 Ζ επηρείξεζε πξέπεη λα είλαη ελήκεξε γηα ηηο πεξηπηώζεηο πνπ
απνζηέιιεηαη ζπλαιιαγή θαη δελ είλαη θαιπκκέλε από
ακθηζβεηήζεηο.
 Ζ ηηκή ηεο παξακέηξνπ «OrderNumber» ζην «cmpi_lookup»

κήλπκα, πξέπεη λα ρξεζηκνπνηεζεί σο ηηκή ζηελ παξάκεηξν
«MerchantReference» ζην «Transaction Web Service» (βι.
ελόηεηα 5).
 Γελ πξέπεη πνηέ λα ζηέιλεηαη ηηκή ζηελ παξάκεηξν

«Installment» ζην «cmpi_lookup» κήλπκα δηόηη δελ αθνξά ην
πιήζνο άηνθσλ δόζεσλ ηεο ζπλαιιαγήο.
΢ηα πιαίζηα ησλ δνθηκαζηηθώλ ζπλαιιαγώλ πνπ ζα πξαγκαηνπνηεζνύλ από ην

ζύζηεκα ηεο επηρείξεζεο, είλαη ππνρξεσηηθό λα θιεζνύλ όια ηα test cases ηεο
δηαδηθαζίαο πηζηνπνίεζεο πνπ αλαθέξζεθαλ παξαπάλσ πξαγκαηνπνηώληαο θάζε
θνξά ηηο θαηάιιειεο ελέξγεηεο. Κεηά ηελ νινθιήξσζε ησλ δνθηκαζηηθώλ
ζπλαιιαγώλ, ζα πξέπεη λα ζηαιεί ζηελ Σξάπεδα Πεηξαηώο ε ηηκή ηεο παξακέηξνπ
«OrderNumber» ηνπ «cmpi_lookup» κελύκαηνο γηα όια ηα test cases.
΢εκείσζε:
Οη ηξόπνη θιήζεο ησλ test cases ηεο δηαδηθαζίαο πηζηνπνίεζεο
πεξηγξάθνληαη ζην θεθάιαην 7 «Integration Testing» ηνπ document
«Centinel.IntegrationGuide.PayerAuthentication.pdf» (ζει. 35).
Δπεηδή ηα ζηνηρεία θαξηώλ πνπ αλαγλσξίδνληαη από ην ηεζη πεξηβάιινλ
ηεο πιαηθόξκαο ηεο Cardinal είλαη δηαθνξεηηθά από ηα ζηνηρεία θαξηώλ
πνπ γίλνληαη δεθηά από ην ηεζη πεξηβάιινλ ηνπ Πεηξαηώο Paycenter,
πξνθεηκέλνπ λα πξαγκαηνπνηεζνύλ ηα test cases ηεο Cardinal
νινθιεξώλνληαο ηηο ζπλαιιαγέο, ζπληζηάηαη:
 ηα test cases ηεο Cardinal λα θιεζνύλ κε ηνλ πξώην ηξόπν θιήζεο
πνπ βαζίδεηαη ζηε ρξήζε ηνπ νλόκαηνο ηνπ test case ζηελ παξάκεηξν
«OrderDescription» ηνπ «cmpi_lookup» κελύκαηνο θαη
 ζηα ζηνηρεία θάξηαο λα ρξεζηκνπνηεζνύλ ηα ζηνηρεία ηνπ Test Case 1
(γηα ζπλαιιαγέο κε Visa) ή ηνπ Test Case 10 (γηα ζπλαιιαγέο κε
Mastercard) ηεο ελόηεηαο 7 (ηα νπνία γίλνληαη δεθηά από ην
δνθηκαζηηθό πεξηβάιινλ ηνπ «Πεηξαηώο Paycenter») ώζηε λα
εθηειεζηεί νινθιεξσκέλε ζπλαιιαγή.
΢ηνλ πίλαθα πνπ αθνινπζεί, ζηνλ νπνίν πεξηιακβάλνληαη νδεγίεο γηα ηηο ελέξγεηεο
ηεο επηρείξεζεο ζε θάζε test case ηεο δηαδηθαζίαο πηζηνπνίεζεο, ν ζπκβνιηζκόο
[cmpi_lookup.ParamName] θαη [cmpi_authenticate.ParamName] δειώλεη
όηη πξέπεη λα ρξεζηκνπνηεζεί ε ηηκή ηεο παξακέηξνπ «ParamName» πνπ
επηζηξάθεθε ζην «cmpi_lookup» θαη «cmpi_authenticate» κήλπκα αληίζηνηρα ηεο
δηαδηθαζίαο πηζηνπνίεζεο. Δηδηθά γηα ηηο παξακέηξνπο «Enrolled», «PAResStatus»
θαη «SignatureVerification», πξέπεη λα ιεθζεί ππόςε ε αληηζηνηρία ηηκώλ όπσο
πεξηγξάθεθε ζηνλ πξνεγνύκελν πίλαθα.
Cases Γηαδηθαζίαο Πηζηνπνίεζεο (3d-secure)
Test Case Κάιπςε από
Δλέξγεηεο Δπηρείξεζεο
Name ακθηζβεηήζεηο
Verified by Θα πξέπεη λα ζηαιεί ζπλαιιαγή ζην Paycenter κε ηα Λαη
Visa
εμήο ζηνηρεία:
Test Case 1
Παξάκεηξνο Σηκή
Cavv [cmpi_authenticate.Cavv]
Eci [cmpi_authenticate.EciFlag]
Xid [cmpi_authenticate.Xid]
Enrolled [cmpi_lookup.Enrolled]
PAResStatus [cmpi_authenticate.PAResStatus]
SignatureVerification [cmpi_authenticate.SignatureVeri
fication]
Verified by
Visa Γε ζα πξέπεη λα ζηαιεί ζπλαιιαγή ζην Paycenter Όρη
Test Case 2
Verified by
Test Case 3
Visa
Test Case 4
fication]
Verified by Δίλαη απόθαζε ηεο επηρείξεζεο αλ ζα ζηαιεί ή όρη Όρη

Visa
ζπλαιιαγή. Δάλ ζηαιεί ζπλαιιαγή, ζα πξέπεη λα
Test Case 5
ρξεζηκνπνηεζνύλ ηα εμήο ζηνηρεία:
fication]

Visa
Test Case 6
Cavv NULL
Eci 07
Xid NULL
Enrolled Undefined
PAResStatus Unknown
SignatureVerification Undefined

Visa
Test Case 7
Cavv NULL
Eci [cmpi_ lookup.EciFlag]
Xid NULL
PAResStatus Unknown

Visa
Test Case 8
Cavv NULL
Xid NULL
PAResStatus Unknown
΢εκείσζε:
Ζ πεξίπησζε απηή εθαξκόδεηαη κεηαμύ
άιισλ, ζηηο business θαη ζηηο αλώλπκεο
πξνπιεξσκέλεο θάξηεο. Δπνκέλσο, αλ
απνθιεηζηνύλ νη ζπλαιιαγέο απηήο ηεο
πεξίπησζεο, δε ζα κπνξνύλ λα
ρξεζηκνπνηεζνύλ νη ελ ιόγσ θάξηεο. Ζ
απόθαζε πξέπεη λα ιεθζεί από ηελ
επηρείξεζε.

Visa
Test Case 9
Cavv NULL
Xid NULL
PAResStatus Unknown
Visa
Test Case 10
Cavv NULL
Xid NULL
PAResStatus Unknown
Verified by
Test Case 11
Mastercard Θα πξέπεη λα ζηαιεί ζπλαιιαγή ζην Paycenter κε ηα Λαη
SecureCode
Test Case 1
fication]
Mastercard
SecureCode Γε ζα πξέπεη λα ζηαιεί ζπλαιιαγή ζην Paycenter Όρη
Test Case 2
Mastercard
Test Case 3
Mastercard Δίλαη απόθαζε ηεο επηρείξεζεο αλ ζα ζηαιεί ή όρη Όρη
SecureCode
Test Case 4
fication]

SecureCode
Test Case 5
Cavv NULL
Eci 01
Xid NULL
Enrolled Undefined
PAResStatus Unknown
Mastercard Θα πξέπεη λα ζηαιεί ζπλαιιαγή ζην Paycenter κε ηα Λαη

SecureCode
Test Case 6
Cavv NULL
Xid NULL
PAResStatus Unknown

SecureCode
Test Case 7
Cavv NULL
Xid NULL
PAResStatus Unknown
΢εκείσζε:
Ζ πεξίπησζε απηή εθαξκόδεηαη κεηαμύ
άιισλ, ζηηο business θαη ζηηο αλώλπκεο
πξνπιεξσκέλεο θάξηεο. Δπνκέλσο, αλ
απνθιεηζηνύλ νη ζπλαιιαγέο απηήο ηεο
πεξίπησζεο, δε ζα κπνξνύλ λα
ρξεζηκνπνηεζνύλ νη ελ ιόγσ θάξηεο. Ζ
απόθαζε πξέπεη λα ιεθζεί από ηελ

SecureCode
Test Case 8
Cavv NULL
Xid NULL
PAResStatus Unknown
SecureCode
Test Case 9
Cavv NULL
Xid NULL
PAResStatus Unknown
Mastercard
Test Case 10
Αδπλακία Δάλ δελ είλαη εθηθηή ε επηθνηλσλία κε ην ζύζηεκα ηεο Όρη
επηθνηλσλίαο
Centinel Cardinal ή επηζηξαθεί νπνηνδήπνηε άιιν
κε
πιαηθόξκα απνηέιεζκα πνπ δελ ηαηξηάδεη κε θάπνην από ηα
Cardinal πξνεγνύκελα cases, είλαη απόθαζε ηεο επηρείξεζεο
αλ ζα ζηαιεί ή όρη ζπλαιιαγή. Δάλ ζηαιεί
ζπλαιιαγή, ζα πξέπεη λα ρξεζηκνπνηεζνύλ ηα εμήο
ζηνηρεία:
Cavv NULL
Eci 07 γηα θάξηεο Visa,
01 γηα θάξηεο Mastercard θαη
Maestro
Xid NULL
Enrolled Undefined
PAResStatus Unknown
Πξνζνρή!
Θα πξέπεη λα ρξεζηκνπνηεζεί ζσζηή ηηκή
ζηελ παξάκεηξν Eci (07 γηα Visa, 01 γηα
Mastercard θαη Maestro)
Πξνζνρή!
Οη νξγαληζκνί (Visa/Mastercard) δελ παξέρνπλ θάιπςε από
ακθηζβήηεζε ζε ζπλαιιαγέο κε business ή αλώλπκεο πξνπιεξσκέλεο
θάξηεο, αλεμάξηεηα από ην απνηέιεζκα ηεο 3D-Secure δηαδηθαζίαο.
5. Paycenter Transaction Web Service
Σν «Paycenter Transaction Web service» είλαη έλα SOAP Web Service πνπ
ρξεζηκνπνηείηαη γηα λα ζηαινύλ ηα ζηνηρεία κηαο ζπλαιιαγήο ζην «Πεηξαηώο
Paycenter». To URL είλαη ην εμήο:
https://paycenter.piraeusbank.gr/services/paymentgateway.asmx
Πξνζνρή!
Ο ρξόλνο timeout γηα ηε ιήςε ηεο απάληεζεο είλαη 60 sec.
Οη πιεξνθνξίεο πνπ ρξεηάδνληαη γηα ηελ θιήζε ηνπ «Transaction Web service»
είλαη νη αθόινπζεο:
ΠΑΡΑΜΔΣΡΟΙ REQUEST
Όλνκα παξακέηξνπ Πεξηγξαθή Σύπνο
AcquirerID Σν id ηνπ acquirer. Παξέρεηαη από ηελ String
Σξάπεδα Πεηξαηώο. (έσο 5
ραξαθηήξεο)
MerchantID Θσδηθόο εκπόξνπ (merchant id). Integer
Παξέρεηαη από ηελ Σξάπεδα Πεηξαηώο.
PosID Αξηζκόο ηεξκαηηθνύ (pos id). Παξέρεηαη Integer
από ηελ Σξάπεδα Πεηξαηώο.
΢εκείσζε:
Δίλαη δπλαηό λα απνζηέιιεηαη ηηκή
NULL ζην PosID. ΢ηελ πεξίπησζε
απηή, ην Πεηξαηώο Paycenter ζα
εθηειέζεη ηε ζπλαιιαγή κε έλα από
ηα δηαζέζηκα PosID. Ζ ινγηθή απηή
ζπληζηάηαη ζε πεξηπηώζεηο πνπ
πξόθεηηαη λα απνζηέιιεηαη κεγάινο
αξηζκόο ηαπηόρξνλσλ ζπλαιιαγώλ,
νπόηε ζα πξέπεη λα ελεκεξσζεί ε
Σξάπεδα Πεηξαηώο ώζηε λα
παξαρζνύλ πεξηζζόηεξα από έλα
PosID.
User Όλνκα ρξήζηε. Παξέρεηαη από ηελ String
Σξάπεδα Πεηξαηώο. (έσο 50
Password Θσδηθόο ρξήζηε θξππηνγξαθεκέλνο κε String
ηνλ MD5 hashing αιγόξηζκν. Παξέρεηαη (έσο 50
από ηελ Σξάπεδα Πεηξαηώο (ζηε κε ραξαθηήξεο)
θξππηνγξαθεκέλε κνξθή).
ChannelType Σύπνο θαλαιηνύ ηνπ ηεξκαηηθνύ. String
Παξέρεηαη από ηελ Σξάπεδα Πεηξαηώο. (έσο 11
RequestType Ο ηύπνο ζπλαιιαγήο πνπ πξόθεηηαη λα String
πξαγκαηνπνηεζεί. Γπλαηέο ηηκέο: (έσο 20
 SALE: Αγνξά  ΢πλαιιαγή πνπ ζα ραξαθηήξεο)
εθθαζαξηζηεί άκεζα ζην ηξέρνλ
παθέην.
 AUTHORIZE: Πξνέγθξηζε  Θα γίλεη
απιά κία δέζκεπζε ηνπ πνζνύ θαη ζα
πξέπεη αξγόηεξα λα γίλεη νινθιήξσζε
ηεο πξνέγθξηζεο (είηε κέζσ ηνπ
δηαρεηξηζηηθνύ εξγαιείνπ AdminTool
είηε κέζσ ηεο ζπλαιιαγήο κε
RequestType = «SETTLE») ώζηε λα
εθθαζαξηζηεί.
 SETTLE: Οινθιήξσζε πξνέγθξηζεο
 Αθνξά ηελ νινθιήξσζε κηαο
πξνέγθξηζεο πξνθεηκέλνπ λα γίλεη
εθθαζάξηζε ηεο ζπλαιιαγήο ζην
ηξέρνλ παθέην.
 VOIDREQUEST:
Αθύξσζε πξνέγθξηζεο  Αθύξσζε
πξνέγθξηζεο ε νπνία δελ έρεη
νινθιεξσζεί.
 REFUND: Αθύξσζε/αληηινγηζκόο
αγνξάο  Αθύξσζε/αληηινγηζκόο
αγνξάο ή πξνέγθξηζεο πνπ έρεη
νινθιεξσζεί.
 FOLLOW_UP: Follow-up ζπλαιιαγήο
 Δπηζηξέθνληαη ηα ζηνηρεία
ζπλαιιαγήο πνπ έρεη ήδε εθηειεζηεί
κε ζπγθεθξηκέλε ηηκή
«MerchantReference» εθόζνλ δελ
έρεη πξαγκαηνπνηεζεί
αθύξσζε/αληηινγηζκόο.
 ISAVAILABLE: Δπηζηξέθεη αλ ην
«Πεηξαηώο Paycenter» είλαη δηαζέζηκν
γηα λα δερζεί ζπλαιιαγέο.
΢εκείσζε:
΢ην ηέινο ηεο ελόηεηαο
πεξηιακβάλεηαη έλα δηάγξακκα κε
ηε ζεηξά κε ηελ νπνία νη
ζπλαιιαγέο κπνξνύλ λα
ρξεζηκνπνηεζνύλ.
Πξνζνρή!
Ζ επηζηξνθή ρξεκάησλ (REFUND)
είλαη επηηξεπηή κέρξη ην πνιύ 180
εκέξεο από ηελ εκεξνκελία ηεο
αληίζηνηρεο ρξέσζεο.
RequestMethod Πξέπεη λα ζηέιλεηαη πάληα ε ηηκή String
«SYNCHRONOUS». (έσο 12
MerchantReference Θσδηθόο αλαθνξάο ηεο ζπλαιιαγήο. String
Παξάγεηαη από ην ζύζηεκα ηεο (έσο 50
επηρείξεζεο θαη ραξαθηεξίδεη κνλαδηθά ραξαθηήξεο)
θάζε επηηπρή ζπλαιιαγή (π.ρ. αξηζκόο
παξαγγειίαο, αξηζκόο ζπκβνιαίνπ θιπ).
 Έρεη κέγηζην κήθνο 50 ραξαθηήξεο.
 Γελ ππνζηεξίδεηαη ε ρξήζε ειιεληθώλ
ραξαθηήξσλ.
 Γελ επηηξέπεηαη ε ρξήζε spaces.
Πξνζνρή!
 Δάλ ρξεζηκνπνηείηαη ε δηαδηθαζία
πηζηνπνίεζεο θαηόρνπ θάξηαο
(«3d-secure»), ε ηηκή ηεο
παξακέηξνπ
«MerchantReference» ζε
ζπλαιιαγέο αγνξάο/πξνέγθξηζεο,
πξέπεη λα είλαη ίδηα κε ηελ ηηκή
ηεο παξακέηξνπ
«OrderNumber» ηνπ κελύκαηνο
«cmpi_lookup» ηεο δηαδηθαζίαο
πηζηνπνίεζεο.
 Δάλ κία ζπλαιιαγή αγνξάο/

πξνέγθξηζεο δελ είλαη επηηπρήο,
κπνξεί λα μαλαζηαιεί ε
ζπλαιιαγή κε ην ίδην
«MerchantReference» εθόζνλ
επαλαιεθζεί ε δηαδηθαζία
πηζηνπνίεζεο («3d-secure»).
 Δθόζνλ κία ζπλαιιαγή αγνξάο ή

πξνέγθξηζεο εγθξηζεί, αθόκε θαη
εάλ αθπξσζεί/αληηινγηζηεί, δελ
είλαη δπλαηό λα ρξεζηκνπνηεζεί
ην «MerchantReference» απηήο
ηεο ζπλαιιαγήο ζε επόκελε
ζπλαιιαγή (βι. θαη ελόηεηα 6).
TransactionReferenceID Υξεζηκνπνηείηαη κόλν ζε ζπλαιιαγέο: Integer
 νινθιήξσζεο πξνέγθξηζεο
(RequestType = «SETTLE»)
 αθύξσζεο πξνέγθξηζεο
(RequestType = «VOIDREQUEST»)
 αθύξσζεο / αληηινγηζκνύ αγνξάο
(RequestType = «REFUND»)
Δίλαη ην transaction id (παξάκεηξνο
«TransactionID» ηεο απάληεζεο) ηεο
ζπλαιιαγήο πνπ δεηείηαη λα νινθιεξσζεί
/ αθπξσζεί / αληηινγηζηεί.
΢εκείσζε:
Δάλ δεηείηαη ε αθύξσζε/
αληηινγηζκόο κίαο πξνέγθξηζεο πνπ
έρεη νινθιεξσζεί, ζηε
ζπγθεθξηκέλε παξάκεηξν ζηέιλεηαη
ην «TransactionID» ηεο
νινθιήξσζεο ηεο πξνέγθξηζεο (θαη
όρη ηεο πξνέγθξηζεο).
EntryType Ο ηξόπνο πνπ δηαβάζηεθαλ ηα ζηνηρεία ηεο String
θάξηαο. Γπλαηέο ηηκέο: (έσο 8
 KeyEntry: Σα ζηνηρεία ηεο θάξηαο ραξαθηήξεο)
πιεθηξνινγήζεθαλ (είηε ειεθηξνληθά
είηε ζε πηζηνπνηεκέλν καγλεηηθό
αλαγλώζηε)
 Swipe: Σα ζηνηρεία ηεο θάξηαο
δηαβάζηεθαλ κέζσ «swipe» ζε
πηζηνπνηεκέλν καγλεηηθό αλαγλώζηε.
(Αθνξά κόλν ζπλαιιαγέο κε θπζηθή
παξνπζία θάξηαο όπνπ ChannelType
= «CardPresent»)
CurrencyCode Ο θσδηθόο λνκίζκαηνο πνπ ζα γίλεη ε Integer
ρξέσζε. Δίλαη 978 γηα ρξέσζε ζε επξώ.
Πξνζνρή!
Γηα θάζε δηαθνξεηηθό λόκηζκα ζα
ρνξεγείηαη από ηελ Πεηξαηώο
δηαθνξεηηθό MerchantID θαη
PosID.
΢εκείσζε:
Οη θσδηθνί ησλ ππνζηεξηδόκελσλ
λνκηζκάησλ πεξηιακβάλνληαη ζην
Παξάξηεκα 2.
Amount Σν πνζό ηεο ζπλαιιαγήο κε 2 δεθαδηθά Decimal κε
ςεθία. Ηζρύνπλ ηα εμήο γηα ηνπο 2 δεθαδηθά
δηάθνξνπο ηύπνπο ζπλαιιαγώλ: ςεθία
 Οινθιήξσζε πξνέγθξηζεο
(RequestType = «SETTLE»): Σν πνζό
κπνξεί λα είλαη κηθξόηεξν ή ίζν κε ην
αξρηθό πνζό ηεο ζπλαιιαγήο.
 Αθύξσζε πξνέγθξηζεο
(RequestType = «VOIDREQUEST»):
Σν πνζό πξέπεη λα είλαη ίζν κε ην
αξρηθό πνζό ηεο ζπλαιιαγήο.
 Αθύξσζε / αληηινγηζκόο αγνξάο
(RequestType = «REFUND»):
Σν πνζό κπνξεί λα είλαη κηθξόηεξν ή
ίζν κε ην αξρηθό πνζό ηεο
ζπλαιιαγήο.
Πξνζνρή!
΢ηε κεξηθή επηζηξνθή ζε
ζπλαιιαγή κε δόζεηο, ην πνζό
επηζηξέθεηαη εθάπαμ.
Installments Σν πιήζνο δόζεσλ ηεο ζπλαιιαγήο. Integer
 Γηα λα ππνζηεξηρζνύλ δόζεηο, ζα
πξέπεη ε επηρείξεζε λα ην δειώζεη
ζηελ ηξάπεδα Πεηξαηώο.
 Γηα ζπλαιιαγή ρσξίο δόζεηο, πξέπεη
λα ζηέιλεηαη ε ηηκή 0, 1 ή NULL.
Πξνζνρή!
΢ε ζπλαιιαγή κε δόζεηο, ζα πξέπεη
ην ζπλνιηθό πνζό λα είλαη ηέηνην
ώζηε ην πνζό θάζε δόζεο λα είλαη
ηνπιάρηζηνλ 30€.
΢εκείσζε:
Ζ Σξάπεδα Πεηξαηώο παξέρεη ην
«BIN Web Service» κέζσ ηνπ
νπνίνπ κπνξεί λα ειεγρζεί αλ κία
θάξηα ππνζηεξίδεη δόζεηο ή όρη
ρσξίο λα πξαγκαηνπνηεζεί
ζπλαιιαγή. ΢ε πεξίπησζε
ελδηαθέξνληνο, ζα πξέπεη λα
δεηεζνύλ από ηελ Σξάπεδα
Πεηξαηώο νη πξνδηαγξαθέο γηα
ηελ θιήζε ηνπ.
ExpirePreauth Αθνξά κόλν ζπλαιιαγέο πξνέγθξηζεο Short
(RequestType = «AUTHORIZE»). Δίλαη ην Integer
πιήζνο εκεξώλ εληόο ηνπ νπνίνπ ε
πξνέγθξηζε κπνξεί λα νινθιεξσζεί.
Μέγηζηε ηηκή: 30 εκέξεο
TipAmount Γηα κειινληηθή ρξήζε. Λα ζηέιλεηαη NULL Decimal κε
ή κεδέλ. 2 δεθαδηθά
ςεθία
Bnpl Γηα κειινληηθή ρξήζε. Λα ζηέιλεηαη NULL. Unsigned
Byte
SessionKey Γηα κειινληηθή ρξήζε. Λα ζηέιλεηαη NULL. String
(έσο 50
CardType Ο ηύπνο θάξηαο. String
(έσο 20
Τπάξρνπλ δύν δπλαηόηεηεο:
1) Λα κε δεηείηαη από ην ρξήζηε λα
εηζάγεη ηνλ ηύπν ηεο θάξηαο ηνπ. ΢ηελ
πεξίπησζε απηή, ε παξάκεηξνο
«CardType» πξέπεη λα ζηέιλεηαη κε
ηηκή «UNKNOWN» θαη ην Πεηξαηώο
Paycenter ζα απνθαζίζεη γηα ηνλ ηύπν
θάξηαο πνπ αθνξά ε ζπλαιιαγή.
2) Λα δεηείηαη από ην ρξήζηε λα εηζάγεη

ηνλ ηύπν ηεο θάξηαο ηνπ. ΢ηελ
πεξίπησζε απηή, νη πηζαλέο ηηκέο ηεο
παξακέηξνπ «CardType» είλαη νη εμήο:
 VISA: VISA θάξηα
 MasterCard: MasterCard θάξηα
 Maestro: Maestro θάξηα. Οη Maestro
κπνξνύλ λα ρξεζηκνπνηεζνύλ κόλν αλ
εθαξκόδεηαη ε 3d-secure δηαδηθαζία.
 DinersClub: DinersClub ή Discover
θάξηα
 AMEX: American Express θάξηα
΢εκείσζε:
 Γηα λα ππνζηεξηρζνύλ Diners/
Discover ή American Express
θάξηεο, ζα πξέπεη ε επηρείξεζε
λα επηθνηλσλήζεη κε ηελ Σξάπεδα
Πεηξαηώο γηα λα ελεκεξσζεί γηα
ηελ απαξαίηεηε εκπνξηθή
δηαδηθαζία.
 ΢πλαιιαγέο κε Diners/Discover ή
American Express θάξηα,
ζηέιλνληαη κε δηαθνξεηηθό
ΜerchantID θαη PosID ζε
ζρέζε κε ηηο Visa / Mastercard /
Maestro ζπλαιιαγέο θαη κε ηηκή
«null» ζην «AuthInfo»
element (πεξηέρνληαη νη
παξάκεηξνη Cavv, Eci, Xid,
Enrolled, PAResStatus,
SignatureVerification – βι.
παξαθάησ)
CardNumber Ο αξηζκόο θάξηαο ηεο ζπλαιιαγήο. Σν String
κέγηζην πιήζνο ςεθίσλ ηεο θάξηαο είλαη (έσο 19
19. αξηζκεηηθά
ςεθία)
ExpirationMonth Ο κήλαο ιήμεο ηεο θάξηαο. Short
integer
ExpirationYear Σν έηνο ιήμεο ηεο θάξηαο. Short
integer
Cvv2 Ο θσδηθόο επαιήζεπζεο ηεο θάξηαο (CVV2 String
ή CVC) πνπ ζπλήζσο αλαγξάθεηαη ζην (έσο 4
πίζσ κέξνο ηεο θάξηαο. αξηζκεηηθά
ςεθία)
΢εκείσζε:
Γηα ζπλαιιαγέο από site, ζην πεδίν
ηνπ cvv2 ζα πξέπεη λα κελ είλαη
εκθαλείο νη ραξαθηήξεο θαηά ηελ
πιεθηξνιόγεζή ηνπο από ην ρξήζηε
(π.ρ. λα εκθαλίδνληαη αζηεξάθηα ζηε
ζέζε ηνπο).
CardHolderName Σν νλνκαηεπώλπκν ηνπ θαηόρνπ ηεο String
θάξηαο όπσο αλαγξάθεηαη επάλσ ζηελ (έσο 100
θάξηα. ραξαθηήξεο)
Πξνζνρή!
Σν νλνκαηεπώλπκν πξέπεη λα
ζηέιλεηαη κε θεθαιαίνπο ιαηηληθνύο
ραξαθηήξεο.
Aid Γηα κειινληηθή ρξήζε. Λα ζηέιλεηαη NULL. String
(έσο 50
Emv Γηα κειινληηθή ρξήζε. Λα ζηέιλεηαη NULL. String
(έσο 512
PinBlock Γηα κειινληηθή ρξήζε. Λα ζηέιλεηαη NULL. String
(έσο 50
Track1 Αθνξά κόλν ζπλαιιαγέο κε θπζηθή String
παξνπζία θάξηαο θαη όηαλ ηα ζηνηρεία ηεο (έσο 100
θάξηαο δηαβάδνληαη κέζσ «swipe» ραξαθηήξεο)
(δειαδή ChannelType = «CardPresent»,
EntryType = «Swipe»). Δίλαη ηα δεδνκέλα
πνπ πεξηιακβάλνληαη ζην track1 ηεο
καγλεηηθήο ηαηλίαο ηεο θάξηαο.
Παξάδεηγκα ηηκήο:
B4111111111111111^NEW TEST 9/NEW
TEST 9 ^140210110000661
Track2 Αθνξά κόλν ζπλαιιαγέο κε θπζηθή String
παξνπζία θάξηαο θαη όηαλ ηα ζηνηρεία ηεο (37
θάξηαο δηαβάδνληαη κέζσ «swipe» ραξαθηήξεο)
(δειαδή ChannelType = «CardPresent»,
EntryType = «Swipe»). Δίλαη ηα δεδνκέλα
πνπ πεξηιακβάλνληαη ζην track2 ηεο
καγλεηηθήο ηαηλίαο ηεο θάξηαο.
Παξάδεηγκα ηηκήο:
4111111111111111=1402101000006610
0000
Cavv Αθνξά κόλν on-line ζπλαιιαγέο κέζσ site String
κε Visa, Mastercard ή Maestro θάξηα. (έσο 48
Πεξηέρεη ηελ ηηκή ηεο παξακέηξνπ «Cavv» ραξαθηήξεο)
πνπ επηζηξάθεθε ζηε 3d-secure
δηαδηθαζία (πιαηθόξκα Cardinal – βι.
ελόηεηα 4).
Eci Αθνξά κόλν on-line ζπλαιιαγέο κέζσ site String
κε Visa, Mastercard ή Maestro θάξηα. (2
Πεξηέρεη ηελ ηηκή ηεο παξακέηξνπ αξηζκεηηθά
«EciFlag» πνπ επηζηξάθεθε ζηε 3d-secure ςεθία)
δηαδηθαζία (πιαηθόξκα Cardinal – βι.
ελόηεηα 4).
Xid Αθνξά κόλν on-line ζπλαιιαγέο κέζσ site String
κε Visa, Mastercard ή Maestro θάξηα. (έσο 40
Πεξηέρεη ηελ ηηκή ηνπ πεδίνπ «Xid» πνπ ραξαθηήξεο)
επηζηξάθεθε ζηε 3d-secure δηαδηθαζία
(πιαηθόξκα Cardinal – βι. ελόηεηα 4).
Enrolled Αθνξά κόλν on-line ζπλαιιαγέο κέζσ site String
κε Visa, Mastercard ή Maestro θάξηα. Ζ (έσο 9
ηηκή ηνπ βαζίδεηαη ζηελ ηηκή ηεο ραξαθηήξεο)
παξακέηξνπ «Enrolled» πνπ επηζηξάθεθε
ζηε 3d-secure δηαδηθαζία (πιαηθόξκα
Cardinal – βι. ελόηεηα 4).
Γπλαηέο ηηκέο:
 Undefined
 Yes
 No
PAResStatus Αθνξά κόλν on-line ζπλαιιαγέο κέζσ site String
παξακέηξνπ «PAResStatus» πνπ
 Unknown
 Attempted
 Succeded
 Failed
SignatureVerification Αθνξά κόλν on-line ζπλαιιαγέο κέζσ site String
παξακέηξνπ «SignatureVerification» πνπ
 Undefined
 Yes
 No
TaxCardNumber Ο αξηζκόο ηεο θάξηαο απνδείμεσλ πνπ String (19
εθδίδεη ην Τπνπξγείν Οηθνλνκηθώλ. ΢ε ραξαθηήξεο)
απηήλ ηελ θάξηα ζα θαηαγξαθεί σο έμνδν
ην πνζό ηεο ζπλαιιαγήο. Γηα ηεζη, κπνξεί
λα ρξεζηκνπνηεζεί ν αξηζκόο
9300907660400000014.
Πξνζνρή!
 Γηα λα γίλεη ρξήζε ηεο θάξηαο
απνδείμεσλ ζην Web Service,
ζα πξέπεη πξώηα λα γίλεη
επηθνηλσλία κε ηελ Σξάπεδα
Πεηξαηώο ώζηε λα ελεξγνπνηεζεί
ε δπλαηόηεηα ρξήζεο,
δηαθνξεηηθά ζα επηζηξέθεηαη
error.
 Ζ παξάκεηξνο είλαη πξναηξεηηθή

θαη κπνξεί λα απνζηέιιεηαη
κόλν ζε ζπλαιιαγέο αγνξάο θαη
πξνέγθξηζεο (RequestType =
«SALE» ή «AUTHORIZE»
αληίζηνηρα).
 ΢ε ζπλαιιαγέο επηζηξνθώλ
δελ πξέπεη λα απνζηέιιεηαη
αξηζκόο θάξηαο απνδείμεσλ.
Κέζσ απηνκαηνπνηεκέλεο
δηαδηθαζίαο ην πνζό αθαηξείηαη
από ηελ θάξηα απνδείμεσλ πνπ
ελδερνκέλσο είρε
ρξεζηκνπνηεζεί ζηε ζπλαιιαγή
ρξέσζεο.
΢εκείσζε:
Κε εμαίξεζε ηελ παξάκεηξν «CardHolderName», ζε θακία από ηηο
ππόινηπεο παξακέηξνπο κε ηύπν String δελ επηηξέπεηαη ε ρξήζε spaces.
Οη παξάκεηξνη πνπ ζηέιλνληαη ζηελ απάληεζε, είλαη νη εμήο:
ΠΑΡΑΜΔΣΡΟΙ RESPONSE
Όλνκα παξακέηξνπ Πεξηγξαθή Σύπνο
RequestType Ο ηύπνο ηεο ζπλαιιαγήο πνπ ζηάιζεθε ζην String
request. Γπλαηέο ηηκέο: (έσο 20
 SALE: Αγνξά ραξαθηήξεο)
 AUTHORIZE: Πξνέγθξηζε
 SETTLE: Οινθιήξσζε πξνέγθξηζεο
 VOIDREQUEST:
Αθύξσζε πξνέγθξηζεο
 REFUND: Αθύξσζε / αληηινγηζκόο
αγνξάο ή νινθιεξσκέλεο πξνέγθξηζεο
 FOLLOW_UP: ΢ηνηρεία ζπλαιιαγήο
πνπ έρεη ήδε εθηειεζηεί κε
ζπγθεθξηκέλε ηηκή
«MerchantReference» (εθόζνλ δελ έρεη
πξαγκαηνπνηεζεί
αθύξσζε/αληηινγηζκόο)
 ISAVAILABLE: Έιεγρνο
δηαζεζηκόηεηαο «Πεηξαηώο Paycenter»
MerchantID Θσδηθόο εκπόξνπ (merchant id) πνπ Integer
ζηάιζεθε ζην request.
PosID Αξηζκόο ηεξκαηηθνύ (pos id) πνπ ζηάιζεθε Integer
ζην request.
User Όλνκα ρξήζηε πνπ ζηάιζεθε ζην request. String
(έσο 50
ChannelType Σύπνο θαλαιηνύ ηνπ ηεξκαηηθνύ πνπ String
ζηάιζεθε ζην request. (έσο 11
ResultCode Ο θσδηθόο απνηειέζκαηνο ηνπ request ν Integer
νπνίνο δειώλεη αλ ππήξμε θάπνην ηερληθό
πξόβιεκα ζηε δηεθπεξαίσζε ηεο
ζπλαιιαγήο. ΢πγθεθξηκέλα:
 Σηκή ίζε κε 0: Γελ ππήξμε θαλέλα
πξόβιεκα θαη ε ζπλαιιαγή
εθηειέζηεθε. Θα πξέπεη ζηε
ζπλέρεηα λα ειεγρζεί ε παξάκεηξνο
«StatusFlag» ώζηε λα δηαπηζησζεί
αλ ε ζπλαιιαγή έρεη εγθξηζεί.
 Σηκή δηάθνξε ηνπ 0: Τπήξμε

θάπνην πξόβιεκα κε ηα δεδνκέλα
ηεο ζπλαιιαγήο ή θάπνηνπ είδνπο
ηερληθό πξόβιεκα ζην «Πεηξαηώο
Paycenter», νπόηε δελ
πξαγκαηνπνηήζεθε ζπλαιιαγή. Ζ
παξάκεηξνο «ResultDescription»
πεξηέρεη πεξηγξαθή ηνπ
πξνβιήκαηνο πνπ ππήξμε.
Δηδηθά γηα ηε ζπλαιιαγή κε RequestType=

«ISAVAILABLE», ηζρύνπλ ηα εμήο:
 Σηκή ίζε κε 0: Σν «Πεηξαηώο
Paycenter» κπνξεί λα δερζεί
ζπλαιιαγέο.
 Σηκή δηάθνξε ηνπ 0: Σν

«Πεηξαηώο Paycenter» δελ κπνξεί
λα δερζεί ζπλαιιαγέο.
΢εκείσζε:
Οη πην ζπρλέο ηηκέο ηνπ
«ResultCode» πεξηιακβάλνληαη ζην
Παξάξηεκα 1.
ResultDescription Ζ πεξηγξαθή πνπ αληηζηνηρεί ζηελ ηηκή ηεο String
παξακέηξνπ «ResultCode». (έσο 1024
΢εκείσζε:
 Γε ζπληζηάηαη ε πιεξνθνξία απηή
λα εκθαλίδεηαη ζην ρξήζηε.
 Δάλ ην request απνξξίθζεθε

ιόγσ anti-fraud ειέγρσλ
(ResultCode = 7001 – βι.
Παξάξηεκα 1), ην
«ResultDescription» πεξηέρεη ηνλ
θσδηθό ηνπ θαλόλα πνπ
ελεξγνπνηήζεθε. Ο θσδηθόο «0»,
αθνξά απόξξηςε ιόγσ εκθάληζεο
ηεο θάξηαο ζε black list. Αλ
γίλεηαη ρξήζε εηδηθώλ θαλόλσλ
γηα ηελ επηρείξεζε, ε Πεηξαηώο ζα
παξέρεη ηνπο θσδηθνύο ησλ
εηδηθώλ θαλόλσλ.
SupportReferenceID Reference id ηνπ request πνπ έγηλε. Έρεη Long
δηαθνξεηηθή ηηκή γηα θάζε request (αθόκε integer
θαη αλ δελ πξαγκαηνπνηήζεθε ζπλαιιαγή).
΢εκείσζε:
Δίλαη απαξαίηεην λα απνζεθεύεηαη ε
ηηκή ηνπ ώζηε αλ ρξεηαζηεί, λα
ρξεζηκνπνηεζεί σο ζεκείν αλαθνξάο
θαηά ηελ επηθνηλσλία κε ηελ
Σξάπεδα Πεηξαηώο.
StatusFlag Ζ ηηκή ηεο παξακέηξνπ δειώλεη αλ ε String
ζπλαιιαγή εγθξίζεθε. Γπλαηέο ηηκέο: (έσο 12
 Success: Ζ ζπλαιιαγή εγθξίζεθε. ραξαθηήξεο)
 Failure: Ζ ζπλαιιαγή δελ
εγθξίζεθε.
ResponseCode ΢ε πεξίπησζε πνπ έρεη δηεθπεξαησζεί String
ζπλαιιαγή, πεξηέρεη ηνλ θσδηθό (2
απάληεζεο. Οη θσδηθνί απάληεζεο γηα ραξαθηήξεο)
εγθεθξηκέλε ζπλαιιαγή είλαη νη εμήο:
00, 08, 10, 11, 16.
Πξνζνρή!
Όηαλ επηζηξαθεί ε ηηκή 11,
ζεκαίλεη όηη έρεη ήδε
πξαγκαηνπνηεζεί επηηπρήο
ζπλαιιαγή κε ην
«MerchantReference» ηνπ request,
επνκέλσο δελ πξαγκαηνπνηήζεθε
λέα ζπλαιιαγή. Γηα πεξηζζόηεξεο
πιεξνθνξίεο, βι. ελόηεηα 6 θαη
ελόηεηα 7, test case 3.
΢εκείσζε:
Οη πην ζπρλέο ηηκέο ηνπ
«ResponseCode» πεξηιακβάλνληαη
ζην Παξάξηεκα 1.
ResponseDescription Ζ πεξηγξαθή πνπ αληηζηνηρεί ζηελ ηηκή ηεο String
παξακέηξνπ «ResponseCode». (έσο 120
΢εκείσζε:
Γε ζπληζηάηαη ε πιεξνθνξία απηή
λα εκθαλίδεηαη ζην ρξήζηε.
TransactionID Δάλ έρεη πξαγκαηνπνηεζεί ζπλαιιαγή, Integer
πεξηέρεη έλα κνλαδηθό αξηζκό ζπλαιιαγήο
πνπ παξάγεηαη από ην Πεηξαηώο Paycenter.
΢εκείσζε:
Δπεηδή ε ηηκή απηή ρξεηάδεηαη ζηελ
παξάκεηξν «TransactionReferenceID»
ζηηο ζπλαιιαγέο:
 νινθιήξσζεο πξνέγθξηζεο
(RequestType = «SETTLE»)
 αθύξσζεο πξνέγθξηζεο
(RequestType=«VOIDREQUEST»)
 αθύξσζεο / αληηινγηζκνύ αγνξάο
(RequestType=«REFUND»),
εάλ πξόθεηηαη λα ρξεζηκνπνηεζνύλ νη
παξαπάλσ ζπλαιιαγέο, ζα πξέπεη λα
απνζεθεύεηαη ε ηηκή ηεο παξακέηξνπ
ηεο αξρηθήο ζπλαιιαγήο (δει. ην
«TransactionID» ηεο πξνέγθξηζεο,
ηεο νινθιήξσζεο ηεο πξνέγθξηζεο ή
ηεο αγνξάο).
MerchantReference Ο θσδηθόο αλαθνξάο ηεο ζπλαιιαγήο πνπ String
ζηάιζεθε ζην request. (έσο 50
ApprovalCode Δάλ έρεη πξαγκαηνπνηεζεί επηηπρήο String
ζπλαιιαγή (δει. όηαλ ResultCode=0 θαη (έσο 6
StatusFlag=Success), πεξηέρεη ηνλ θσδηθό ραξαθηήξεο)
έγθξηζεο ηεο ζπλαιιαγήο.
PackageNo Δάλ έρεη πξαγκαηνπνηεζεί ζπλαιιαγή (δει. Integer
όηαλ ResultCode=0), πεξηέρεη ηνλ αξηζκό
παθέηνπ πνπ αλήθεη ε ζπλαιιαγή.
RetrievalRef Δάλ έρεη πξαγκαηνπνηεζεί ζπλαιιαγή (δει. String
όηαλ ResultCode=0), πεξηέρεη έλαλ αξηζκό (έσο 12
(Retrieval Reference Number) πνπ ραξαθηήξεο)
παξάγεηαη από ην acquiring ζύζηεκα.
TransactionDateTime Δάλ έρεη πξαγκαηνπνηεζεί ζπλαιιαγή (δει. DateTime
όηαλ ResultCode = 0), πεξηέρεηαη ε
εκεξνκελία θαη ώξα εθηέιεζεο ηεο
SessionKey Γηα κειινληηθή ρξήζε. Απνζηέιιεηαη NULL. String
(έσο 50
TransactionTraceNum Δάλ έρεη πξαγκαηνπνηεζεί ζπλαιιαγή (δει. Integer
όηαλ ResultCode = 0), πεξηέρεηαη ν αύμσλ
αξηζκόο ηεο ζπλαιιαγήο εληόο ηνπ παθέηνπ
πνπ αλήθεη.
΢εκείσζε:
 Δίλαη ππνρξεσηηθό λα απνζεθεύνληαη ζην ζύζηεκα ηεο επηρείξεζεο θαη
λα είλαη δηαζέζηκεο ζηνπο ππεύζπλνπο ηεο επηρείξεζεο νη ηηκέο ησλ
παξακέηξσλ «SupportReferenceID» θαη «MerchantReference»
όισλ ησλ ζπλαιιαγώλ.
 Δάλ ρξεζηκνπνηνύληαη θάπνηεο από ηηο ζπλαιιαγέο νινθιήξσζεο

πξνέγθξηζεο, αθύξσζεο πξνέγθξηζεο θαη/ή αθύξσζεο-αληηινγηζκνύ
αγνξάο, πξέπεη λα απνζεθεύεηαη θαη ην «TransactionID».
 Από ηηο ππόινηπεο παξακέηξνπο, ζπληζηάηαη επηπιένλ λα

απνζεθεύνληαη νη ηηκέο ησλ παξακέηξσλ «ResultCode»,
«ResultDescription», «StatusFlag», «ResponseCode»,
«ResponseDescription», «ApprovalCode», «PackageNo».
 Tα κελύκαηα απόξξηςεο ζπλαιιαγήο ή ηερληθνύ ιάζνπο

(«ResultDescription» θαη «ResponseDescription») δε ζα πξέπεη λα
εκθαλίδνληαη απηνύζηα ζηε ζειίδα ηνπ ρξήζηε.
΢ηνλ πίλαθα πνπ αθνινπζεί, εκθαλίδνληαη νη παξάκεηξνη ηνπ «Transaction Web

Service» πνπ πξέπεη λα ρξεζηκνπνηεζνύλ ζην request θάζε είδνπο ζπλαιιαγήο.
΢ηηο ζπλαιιαγέο αγνξάο («SALE») θαη πξνέγθξηζεο («AUTHORIZE»), νη
παξάκεηξνη πνπ ρξεζηκνπνηνύληαη εμαξηώληαη από ηελ ηηκή ηνπ «ChannelType»
(«3DSecure», «MOTO» ή «CardPresent») ε νπνία δίλεηαη από ηελ ηξάπεδα
Πεηξαηώο.
SALE AUTHORIZE SETTLE VOIDREQUEST REFUND FOLLOW_UP ISAVAILABLE
(ΑΓΟΡΑ) (ΠΡΟΔΓΘΡΗ΢Ζ) (ΟΙΟΘΙΖΡΩ΢Ζ (ΑΘΤΡΩ΢Ζ (ΑΘΤΡΩ΢Ζ/ (FOLLOW UP (ΔΙΔΓΥΟ΢
ΠΡΟΔΓΘΡΗ΢Ζ΢) ΠΡΟΔΓΘΡΗ΢Ζ΢) ΔΠΗ΢ΣΡΟΦΖ ΑΓΟΡΑ΢) ΢ΤΛΑΙΙΑΓΖ΢) ΓΗΑΘΔ΢ΗΚΟΣΖΣΑ΢
PAYCENTER)
CardPresent
CardPresent
REQUEST PARAMETERS
3DSecure
3DSecure
MOTO
MOTO
Γηα όιεο ηηο Γηα όιεο ηηο Γηα όιεο ηηο
Γηα όιεο ηηο ηηκέο ηνπ Γηα όιεο ηηο ηηκέο ηνπ
ηηκέο ηνπ ηηκέο ηνπ ηηκέο ηνπ
ChannelType ChannelType
ChannelType ChannelType ChannelType
AcquirerID
MerchantID
PosID
User
Password
ChannelType
RequestType
RequestMethod
MerchantReference
TransactionReferenceID
EntryType
CurrencyCode
Amount
Installments (1) (1) (1) (1) (1) (1)
ExpirePreauth
TipAmount
Bnpl
SessionKey
CardType (2) (2)
CardNumber (2) (2)
ExpirationMonth (2) (2)
ExpirationYear (2) (2)
Cvv2 (2) (2)
CardHolderName (2) (2)
Aid
Emv
PinBlock
Track1 (3) (3)
Track2 (3) (3)
Cavv (4) (4)
Eci
Xid (4) (4)
Enrolled
PAResStatus
SignatureVerification
TaxCardNumber (5) (5) (5) (5) (5) (5)
ΔΠΔΞΗΓΗ΢ΔΙ΢ ΢ΤΜΒΟΛΧΝ
΢ύκβνιν Δπεμήγεζε
Πξέπεη λα ζηέιλεηαη ηηκή
Γελ πξέπεη λα ζηέιλεηαη ηηκή
(1) ΢ηέιλεηαη ηηκή αλ πξόθεηηαη γηα ζπλαιιαγή κε δόζεηο
(2) ΢ηέιλνληαη ηηκέο κόλν αλ EntryType = «KeyEntry»
(3) ΢ηέιλνληαη ηηκέο κόλν αλ EntryType = «Swipe»
Ζ απνζηνιή ηηκήο εμαξηάηαη από ην απνηέιεζκα ηεο δηαδηθαζίαο
(4) πηζηνπνίεζεο ηνπ θαηόρνπ θάξηαο («3d-secure» δηαδηθαζία) – βι.
ελόηεηα 4.
΢ηέιλνληαη ηηκή αλ ν θάηνρνο ηεο θάξηαο εηζάγεη αξηζκό θάξηαο
(5)
απνδείμεσλ.
΢ην δηάγξακκα πνπ αθνινπζεί, εκθαλίδεηαη ε ζεηξά κε ηελ νπνία νη δηάθνξνη ηύπνη
ζπλαιιαγώλ κπνξνύλ λα ρξεζηκνπνηεζνύλ. ΢πγθεθξηκέλα, όπσο θαίλεηαη θαη ζην
δηάγξακκα, ηζρύνπλ ηα εμήο:
 Κία πξνέγθξηζε (RequestType=«AUTHORIZE»), κπνξεί είηε λα

νινθιεξσζεί (RequestType=«SETTLE») κε πνζό κηθξόηεξν ή ίζν κε ηεο
πξνέγθξηζεο, είηε λα αθπξσζεί (RequestType=«VOIDREQUEST») κε πνζό
αθξηβώο ίζν κε ην πνζό ηεο πξνέγθξηζεο.
 Κία πξνέγθξηζε πνπ έρεη νινθιεξσζεί (RequestType=«SETTLE»), κπνξεί

λα αθπξσζεί/αληηινγηζηεί (RequestType=«REFUND») κε πνζό κηθξόηεξν ή
ίζν από απηό ηεο νινθιεξσκέλεο πξνέγθξηζεο. Πξνζνρή! ΢ηε κεξηθή
επηζηξνθή ζε ζπλαιιαγή κε δόζεηο, ην πνζό επηζηξέθεηαη εθάπαμ.
 Κία ζπλαιιαγή αγνξάο, κπνξεί λα αθπξσζεί/αληηινγηζηεί

(RequestType=«REFUND») κε πνζό κηθξόηεξν ή ίζν από απηό ηεο αγνξάο.
Πξνζνρή! ΢ηε κεξηθή επηζηξνθή ζε ζπλαιιαγή κε δόζεηο, ην πνζό
επηζηξέθεηαη εθάπαμ.
 Ζ ζπλαιιαγή κε RequestType=«FOLLOW_UP» κπνξεί λα ρξεζηκνπνηεζεί

νπνηαδήπνηε ζηηγκή θαη επηζηξέθεη ηα ζηνηρεία ελόο request πνπ έρεη ήδε
ζηαιεί εθόζνλ δελ έρεη πξαγκαηνπνηεζεί αθύξσζε/αληηινγηζκόο.
΢εκείσζε:
΢ηηο παξαθάησ ζπλαιιαγέο, ρξεηάδεηαη λα ζπκπιεξσζεί ηηκή ζηελ
παξάκεηξν «TransactionReferenceID»:
 νινθιήξσζεο πξνέγθξηζεο (RequestType = «SETTLE»)
 αθύξσζεο πξνέγθξηζεο (RequestType = «VOIDREQUEST»)
 αθύξσζεο / αληηινγηζκνύ αγνξάο ή νινθιεξσκέλεο πξνέγθξηζεο
΢ε θάζε πεξίπησζε απνζηέιιεηαη ην transaction id (παξάκεηξνο

«TransactionID» ηεο απάληεζεο) ηεο ζπλαιιαγήο πνπ πξνεγήζεθε. Γηα
παξάδεηγκα, ζηελ νινθιήξσζε πξνέγθξηζεο, ρξεζηκνπνηείηαη ην
«TransactionID» ηεο αξρηθήο πξνέγθξηζεο, ελώ ζηελ
αθύξσζε/αληηινγηζκό νινθιεξσκέλεο πξνέγθξηζεο, ρξεζηκνπνηείηαη ην
«TransactionID» ηεο νινθιήξσζεο ηεο πξνέγθξηζεο.
Διάγραμμα 2: Σειρά εκηέλεζης ζσναλλαγών
6. Ρνή Δλεξγεηώλ Δθαξκνγήο Δπηρείξεζεο
Κεηά ηελ αλάιπζε όισλ ησλ επηκέξνπο ηκεκάησλ ηεο δηαδηθαζίαο πνπ πξέπεη λα
πινπνηεζεί (δηαδηθαζία πηζηνπνίεζεο θαηόρνπ θάξηαο θαη απνζηνιή ζπλαιιαγήο
ζην «Πεηξαηώο Paycenter»), απεηθνλίδεηαη ζε κνξθή δηαγξάκκαηνο ε ξνή ησλ
ελεξγεηώλ πνπ ζπλνιηθά πξέπεη λα πξαγκαηνπνηεζνύλ από ηελ εθαξκνγή ηεο
επηρείξεζεο ζε ζπλεξγαζία κε ην «Πεηξαηώο Paycenter», ώζηε λα εθηειεζηεί κία
ζπλαιιαγή.
Δίλαη ζεκαληηθό λα ρξεζηκνπνηεζεί ν πξνηεηλόκελνο αιγόξηζκνο ώζηε λα ιεθζνύλ

ππόςε όιεο νη πεξηπηώζεηο θαη λα κελ ππάξμνπλ πξνβιήκαηα θαηά ηελ
παξαγσγηθή ιεηηνπξγία ηεο εθαξκνγήο.
Διάγραμμα 3: Ενέργειες εθαρμογής επιτείρηζης
Όπσο θαίλεηαη από ην δηάγξακκα, ε ζπλνιηθή δηαδηθαζία απνηειείηαη από ηηο
παξαθάησ 3 θάζεηο:
1. Γηαδηθαζία Πηζηνπνίεζεο Καηόρνπ Κάξηαο («3d-secure»)
Γηα ζπλαιιαγέο αγνξάο ή πξνέγθξηζεο πνπ πξαγκαηνπνηνύληαη κέζσ site (on-line

ζπλαιιαγέο) κε θάξηα Visa, Mastercard ή Maestro, εθηειείηαη ε δηαδηθαζία
πηζηνπνίεζεο θαηόρνπ θάξηαο (βι. ελόηεηα 4). Αλάινγα κε ην απνηέιεζκα ηεο
δηαδηθαζίαο πηζηνπνίεζεο, ε εθαξκνγή ηεο επηρείξεζεο απνθαζίδεη αλ ζα ζηείιεη ηε
ζπλαιιαγή ή όρη ζην «Πεηξαηώο Paycenter».
Πξνζνρή!
Ζ δηαδηθαζία πηζηνπνίεζεο ρξεζηκνπνηείηαη κόλν γηα on-line
ζπλαιιαγέο αγνξάο ή πξνέγθξηζεο κε Visa, Mastercard ή Maestro
θάξηα.
2. Έιεγρνο & Δθηέιεζε ΢πλαιιαγήο
Σν ζύζηεκα ηεο επηρείξεζεο ρξεζηκνπνηεί ην «Transaction Web Service» γηα λα

ζηείιεη ηα ζηνηρεία ηεο ζπλαιιαγήο ζην «Πεηξαηώο Paycenter» (βι. ελόηεηα 5). To
«Πεηξαηώο Paycenter» πξαγκαηνπνηεί βαζηθνύο ειέγρνπο ζηα ζηνηρεία πνπ
ζηάιζεθαλ θαη εθόζνλ είλαη ζσζηά, απνζηέιινληαη ηα ζηνηρεία ηεο ζπλαιιαγήο
ζηελ εθδόηξηα Σξάπεδα ηεο θάξηαο. ΢ηε ζπλέρεηα, απνζηέιιεηαη ε απάληεζε ζην
ζύζηεκα ηεο επηρείξεζεο.
3. Δπεμεξγαζία Απάληεζεο
Σν ζύζηεκα ηεο επηρείξεζεο πξέπεη λα ειέγμεη ηηο παξακέηξνπο ηεο απάληεζεο,

ώζηε λα δηαπηζηώζεη αλ ε ζπλαιιαγή ήηαλ επηηπρήο ή όρη. ΢πγθεθξηκέλα:
 Αλ ResultCode ≠ «0», ζεκαίλεη όηη είηε ππήξμε θάπνην πξόβιεκα κε ηα

ζηνηρεία ηεο ζπλαιιαγήο, είηε πξνέθπςε θάπνηνπ άιινπ είδνπο ηερληθό
πξόβιεκα, άξα ε ζπλαιιαγή δελ πξαγκαηνπνηήζεθε. Πεξηγξαθή ηνπ
πξνβιήκαηνο ππάξρεη ζηελ παξάκεηξν «ResultDescription» (ε νπνία δελ
πξέπεη λα παξνπζηαζηεί ζηε ζειίδα ηνπ ρξήζηε). Δάλ θξίλεηαη αλαγθαίν,
απνζεθεύνληαη ζην ζύζηεκα ηεο επηρείξεζεο ζηνηρεία πνπ αθνξνύλ ην ηερληθό
πξόβιεκα (SupportReferenceID, MerchantReference, ResultCode,
ResultDescription).
 Αλ ResultCode = «0»:
 Αλ StatusFlag ≠ «Success», ζεκαίλεη όηη πξαγκαηνπνηήζεθε ζπλαιιαγή
ε νπνία όκσο δελ εγθξίζεθε από ηελ εθδόηξηα Σξάπεδα ηεο θάξηαο.
Δάλ θξίλεηαη αλαγθαίν, απνζεθεύνληαη ζην ζύζηεκα ηεο επηρείξεζεο
ζηνηρεία πνπ αθνξνύλ ηελ αλεπηηπρή ζπλαιιαγή (SupportReferenceID,
MerchantReference, ResponseCode, ResponseDescription).
 Αλ StatusFlag = «Success»,
 Αλ ResponseCode = «11», ζεκαίλεη όηη έρεη ήδε
πξαγκαηνπνηεζεί επηηπρήο ζπλαιιαγή κε ην ζπγθεθξηκέλν
«MerchantReference», δειαδή πξόθεηηαη γηα πξνζπάζεηα
δηπινρξέσζεο. ΢ηελ πεξίπησζε απηή, δελ έρεη πξαγκαηνπνηεζεί
λέα ζπλαιιαγή, νπόηε ε θάξηα δε ρξεώζεθε εθ λένπ. Δάλ
θξίλεηαη αλαγθαίν, κπνξεί λα ελεκεξσζεί ην ζύζηεκα ηεο
επηρείξεζεο γηα ηελ πξνζπάζεηα δηπινρξέσζεο.
Πξνζνρή!
Αλ ResponseCode = «11», ζεκαίλεη όηη ην
«MerchantReference» ηνπ request έρεη ήδε
ρξεζηκνπνηεζεί ζε επηηπρή ζπλαιιαγή, νπόηε δελ
πξαγκαηνπνηείηαη λέα ζπλαιιαγή θαη επηζηξέθνληαη
ηα ζηνηρεία ηεο ήδε εθηειεζκέλεο επηηπρνύο
 Αλ ResponseCode ≠ «11», ζεκαίλεη όηη ε ζπλαιιαγή ήηαλ

επηηπρήο, νπόηε ζα πξέπεη λα απνζεθεπηνύλ πιεξνθνξίεο πνπ
αθνξνύλ ηε ζπλαιιαγή, όπσο SupportReferenceID,
MerchantReference, TransactionID, StatusFlag, ResponseCode,
ResponseDescription, ApprovalCode, PackageNo θαη λα
ελεκεξσζεί ην ζύζηεκα ηεο επηρείξεζεο γηα ηελ επηηπρή
ζπλαιιαγή.
Πξνζνρή!
 Αλ ResponseCode = 11, πξέπεη λα ειεγρζεί (εηδηθά ζηελ έλαξμε
ηεο ζπλεξγαζίαο κε ην «Πεηξαηώο Paycenter») κήπσο από ιάζνο ε
εθαξκνγή ηεο επηρείξεζεο ζηέιλεη ην ίδην «MerchantReference»
γηα θάζε ζπλαιιαγή.
 Ζ ηηκή ηνπ «SupportReferenceID» ζα πξέπεη πάληα λα

απνζεθεύεηαη γηα λα κπνξεί λα ρξεζηκνπνηεζεί σο ζεκείν
αλαθνξάο θαηά ηελ επηθνηλσλία ηεο επηρείξεζεο κε ηελ ηξάπεδα
Πεηξαηώο.
΢εκείσζε:
 Πξνηείλεηαη ν Θσδηθόο Έγθξηζεο («ApprovalCode») ηεο
ζπλαιιαγήο λα εκθαλίδεηαη ή θαη λα απνζηέιιεηαη ζε ηπρόλ email
επηβεβαίσζεο ηεο ζπλαιιαγήο από ηελ επηρείξεζε πξνο ην ρξήζηε.
 ΢πληζηάηαη ηα κελύκαηα απόξξηςεο ζπλαιιαγήο ή ηερληθνύ ιάζνπο

(ResultDescription, ResponseDescription) λα κελ εκθαλίδνληαη
απηνύζηα ζηε ζειίδα ηνπ ρξήζηε.
7. Transaction Web Service Test Cases
Παξαθάησ έρνπλ θαηαγξαθεί ηα test cases πνπ κπνξνύλ λα εθηειεζηνύλ ζην test
πεξηβάιινλ ηεο ππεξεζίαο «Πεηξαηώο Paycenter» (θιήζε ηνπ Transaction Web
Service). Δίλαη ππνρξεσηηθό λα γίλνπλ δνθηκαζηηθέο ζπλαιιαγέο γηα όια ηα test
cases πνπ έρνπλ ηελ έλδεημε «ΤΠΟΥΡΔΩΣΗΘΟ». Από ηα πξναηξεηηθά κπνξνύλ λα
εθηειεζηνύλ όζα θξίλεηαη θαηά πεξίπησζε όηη έρνπλ εθαξκνγή ζην ζύζηεκα πνπ
πινπνηείηαη.
΢ε ζπζηήκαηα on-line ζπλαιιαγώλ, πξέπεη θάζε θνξά λα πξνεγείηαη ε δηαδηθαζία
3d-secure ρξεζηκνπνηώληαο νπνηνδήπνηε από ηα cases ηεο ελόηεηαο 4.
Γεληθόηεξα, ηα παξαθάησ ηεζη είλαη ηα πην ζπλεζηζκέλα ζελάξηα πνπ
παξνπζηάδνληαη ζε ζπζηήκαηα παξαγσγήο.
Κία ζπλνπηηθή ιίζηα ησλ test cases είλαη ε παξαθάησ:
Α/Α ΣΙΣΛΟ΢ ΤΠΟΥΡΔΧΣΙΚΟ

Test case 1 APPROVED TRANSACTION (VISA) ΛΑΗ
Test case 2 DECLINED TRANSACTION ΛΑΗ
Test case 3 RECHARGE ATTEMPT ΛΑΗ
Test case 4 COMMUNICATION ERROR ΛΑΗ
Test case 5 INVALID CARD NUMBER ΛΑΗ
Test case 6 UNDER-PROCESS TRANSACTION WAS ΛΑΗ
RE-SENT
Test case 7 BATCH IS CLOSING ΛΑΗ
Test case 8 GENERAL ERROR ΛΑΗ
Test case 9 APPROVED TRANSACTION WITH ΟΥΗ
INSTALLMENTS
Test case 10 APPROVED TRANSACTION (MASTERCARD) ΟΥΗ
Test case 11 APPROVED TRANSACTION (MAESTRO) ΟΥΗ
Test case 12 APPROVED TRANSACTION (DINERS) ΟΥΗ
Test case 13 APPROVED TRANSACTION (DISCOVER) ΟΥΗ
Test case 14 APPROVED TRANSACTION (AMERICAN ΟΥΗ
EXPRESS)
Test case 15 APPROVED TRANSACTION (GBP) ΟΥΗ

Test case 16 APPROVED TRANSACTION (USD) ΟΥΗ
΢ε όια ηα test cases ηζρύνπλ ηα παξαθάησ:

 Οη ηηκέο ησλ παξακέηξσλ «AcquirerID», «MerchantID», «PosID», «User»,
«Password» παξέρνληαη από ηελ Σξάπεδα Πεηξαηώο.
 Ζ παξάκεηξνο «RequestType» ζπκπιεξώλεηαη αλάινγα κε ην είδνο ηεο
ζπλαιιαγήο (βι. ελόηεηα 5) .
 Ζ παξάκεηξνο «Amount» κπνξεί λα πεξηέρεη νπνηαδήπνηε έγθπξε ηηκή (βι.
ελόηεηα 5).
 Οη ηηκέο ησλ παξακέηξσλ «Installments», «CurrencyCode»,
«ExpirePreauth», «CardType», «CardNumber», «ExpirationMonth»,
«ExpirationYear», «CVV2» ζπκπιεξώλνληαη κε ηηο ηηκέο πνπ αλαθέξνληαη
ζηα test cases.
΢εκείσζε:
 Τπελζπκίδεηαη όηη ε πξνέγθξηζε είλαη ζπλαιιαγή κε ηελ νπνία
πξαγκαηνπνηείηαη απιά κία δέζκεπζε πνζνύ θαη ζα πξέπεη λα γίλεη
νινθιήξσζε ηεο πξνέγθξηζεο από ηελ επηρείξεζε (είηε κέζσ ηνπ
Πεηξαηώο Paycenter AdminTool, είηε κέζσ θιήζεο ηνπ Transaction Web
Service) εληόο ησλ εκεξώλ πνπ έρνπλ νξηζηεί κέζσ ηεο παξακέηξνπ
«ExpirePreauth», ώζηε λα γίλεη εθθαζάξηζε ηεο ζπλαιιαγήο.
 ΢ηηο δνθηκαζηηθέο ζπλαιιαγέο ησλ πξνεγθξίζεσλ, ε παξάκεηξνο

«ExpirePreauth» πξέπεη λα έρεη ηηκή αθξηβώο 30, αιιά ζην live
πεξηβάιινλ κπνξεί λα έρεη ηηκή κεηαμύ 2 θαη 30 (αλ ρξεζηκνπνηνύληαη
πξνεγθξίζεηο).
Test Case 1: APPROVED TRANSACTION (VISA)
ΤΠΟΥΡΔΧΣΙΚΟ
΢ελάξην: Έγθξηζε ζπλαιιαγήο (ρσξίο δόζεηο) κε θάξηα Visa
Πόηε εθαξκόδεηαη:
Όηαλ ResultCode=0 θαη StatusFlag=Success θαη ResponseCode ≠ 11
Input παξάκεηξνη:
ExpirePreauth γηα αγνξά 0
ExpirePreauth γηα πξνέγθξηζε 30
Currency 978
Installments 0
CardType VISA ή UNKNOWN
CardNumber γηα αγνξά 4111111111111111
CardNumber γηα πξνέγθξηζε 4000000000000002
ExpirationMonth 01
ExpirationYear Οποιοδήποηε μελλονηικό
CVV2 123
Παξάκεηξνη απάληεζεο:
ResultCode 0
ResponseCode 00
Δλέξγεηεο εθαξκνγήο επηρείξεζεο:

 Δκθάληζε κελύκαηνο έγθξηζεο ζπλαιιαγήο ζηε ζειίδα ηνπ ρξήζηε
 Απνζήθεπζε ηηκώλ ησλ παξακέηξσλ SupportReferenceID,
ResponseDescription, ApprovalCode, PackageNo
 Δλεκέξσζε εθαξκνγήο επηρείξεζεο γηα ηελ επηηπρή ζπλαιιαγή
Test Case 2: DECLINED TRANSACTION
΢ελάξην: Απόξξηςε ζπλαιιαγήο
Όηαλ ResultCode=0 θαη StatusFlag=Failure
Currency 978
Installments 0
ExpirationMonth 02
CVV2 123
ResultCode 0
ResponseCode 12

 Δκθάληζε κελύκαηνο απόξξηςεο ζπλαιιαγήο από ηελ εθδόηξηα
Σξάπεδα ζηε ζειίδα ηνπ ρξήζηε
MerchantReference, ResponseCode, ResponseDescription
 Δλεκέξσζε εθαξκνγήο επηρείξεζεο γηα ηελ απόξξηςε ηεο
ζπλαιιαγήο
Test Case 3: RECHARGE ATTEMPT
΢ελάξην: Απόπεηξα δηπινρξέσζεο ζπλαιιαγήο (ζηάιζεθε request κε ηηκή ζην
«MerchantReference» πνπ έρεη ήδε ρξεζηκνπνηεζεί ζε εγθεθξηκέλε ζπλαιιαγή)
Πξνζνρή!
Όηαλ επηζηξαθεί ResponseCode 11, ζεκαίλεη όηη έρεη ήδε
πξαγκαηνπνηεζεί επηηπρήο ζπλαιιαγή κε ην «MerchantReference» ηνπ
request, επνκέλσο δελ πξαγκαηνπνηήζεθε λέα ζπλαιιαγή.
Όηαλ ResultCode=0 θαη ResponseCode = 11
Currency 978
Installments 0
ExpirationMonth 03
CVV2 123
ResultCode 0
ResponseCode 11

 Δλεκέξσζε εθαξκνγήο επηρείξεζεο γηα ηελ πξνζπάζεηα
δηπινρξέσζεο (αλ θξίλεηαη αλαγθαίν ώζηε λα ειεγρζεί πην αλαιπηηθά)
Test Case 4: COMMUNICATION ERROR
΢ελάξην: Αδπλακία εθηέιεζεο ζπλαιιαγήο ιόγσ (ηερληθνύ) πξνβιήκαηνο
επηθνηλσλίαο κε ην ζύζηεκα επεμεξγαζίαο ησλ ζπλαιιαγώλ
Όηαλ ResultCode = 50x (δει 500, 501 θιπ)
Currency 978
Installments 0
ExpirationMonth 04
CVV2 123
ResultCode 500
ResponseCode

 Δκθάληζε κελύκαηνο αδπλακίαο εθηέιεζεο ζπλαιιαγήο ζηε ζειίδα
ηνπ ρξήζηε (κε πξνηξνπή λα πξνζπαζήζεη αξγόηεξα)
MerchantReference, ResultCode, ResultDescription
 Δλεκέξσζε εθαξκνγήο επηρείξεζεο γηα ηελ αδπλακία εθηέιεζεο ηεο
Test Case 5: INVALID CARD NUMBER
΢ελάξην: Αδπλακία εθηέιεζεο ζπλαιιαγήο ιόγσ εηζαγσγήο ιαλζαζκέλσλ
ζηνηρείσλ θάξηαο ή θάξηαο πνπ δελ ππνζηεξίδεηαη από ην ζύζηεκα
Όηαλ ResultCode = 981
Currency 978
Installments 0
ExpirationMonth 05
CVV2 123
ResultCode 981
ResponseCode

ηνπ ρξήζηε (κε πξνηξνπή λα πξνζπαζήζεη μαλά θαη λα ειέγμεη ηα
ζηνηρεία ηεο θάξηαο ηνπ ή λα εηζάγεη άιιε θάξηα)
Test Case 6: UNDER-PROCESS TRANSACTION WAS RE-SENT
΢ελάξην: Πξνζπάζεηα απνζηνιήο ζπλαιιαγήο κε «MerchantReference» ίδην κε
απηό ζπλαιιαγήο πνπ ην Πεηξαηώο Paycenter ήδε επεμεξγάδεηαη (κπνξεί λα κελ
έρεη ιεθζεί απάληεζε από ηελ εθδόηξηα Σξάπεδα ή λα έρεη παξνπζηαζηεί πξόβιεκα
ζην ζύζηεκα επεμεξγαζίαο ζπλαιιαγώλ κε απνηέιεζκα ε ζπλαιιαγή λα έρεη
«θνιιήζεη»)
Currency 978
Installments 0
ExpirationMonth 06
CVV2 123
ResultCode 1045
ResponseCode

ζπλαιιαγήο θαη πξνηξνπή επηρείξεζεο λα δηεξεπλήζεη ην status ηεο
ζπλαιιαγήο κέζσ ηνπ Πεηξαηώο Paycenter AdminTool
΢εκείσζε:
Ζ πξνηξνπή ηνπ ρξήζηε λα πξνζπαζήζεη μαλά ζπληζηάηαη, δηόηη εάλ ηειηθά
εθηειεζηεί επηηπρώο ε αξρηθή ζπλαιιαγή, ηόηε κε επόκελε πξνζπάζεηα, ζα
αλαπαξαρζεί ε πεξίπησζε ηνπ Test case 3.
Test Case 7: BATCH IS CLOSING
΢ελάξην: Κε πξαγκαηνπνίεζε ζπλαιιαγήο ιόγσ ηεο δηαδηθαζίαο εθθαζάξηζεο ησλ
ζπλαιιαγώλ ηνπ ηξέρνληνο παθέηνπ (θιείζηκν παθέηνπ) πνπ πξαγκαηνπνηείηαη
εθείλε ηε ζηηγκή
Currency 978
Installments 0
ExpirationMonth 07
CVV2 123
ResultCode 1072
ResponseCode

ζπλαιιαγήο (εάλ θξίλεηαη αλαγθαίν)
Test Case 8: GENERAL ERROR
΢ελάξην: Κε πξαγκαηνπνίεζε ζπλαιιαγήο ιόγσ πξνζσξηλνύ ηερληθνύ
πξνβιήκαηνο
Currency 978
Installments 0
ExpirationMonth 08
CVV2 123
ResultCode 1
ResponseCode

 Δκθάληζε κελύκαηνο αδπλακίαο εθηέιεζεο ζπλαιιαγήο ιόγσ
πξνζσξηλνύ ηερληθνύ πξνβιήκαηνο ζηε ζειίδα ηνπ ρξήζηε (κε
πξνηξνπή λα πξνζπαζήζεη αξγόηεξα)
ζπλαιιαγήο (εάλ θξίλεηαη αλαγθαίν)
Test Case 9: APPROVED TRANSACTION WITH INSTALLMENTS
ΠΡΟΑΙΡΔΣΙΚΟ
΢ελάξην: Έγθξηζε ζπλαιιαγήο κε δόζεηο
Currency 978
Installments 3
ExpirationMonth 08
CVV2 123
Amount Μεγαλύηερο από 90
ResultCode 0
ResponseCode 00

 Δκθάληζε κελύκαηνο έγθξηζεο ζπλαιιαγήο ζηε ζειίδα ηνπ ρξήζηε ζε
«x» δόζεηο (όπνπ «x» ην πιήζνο ησλ δόζεσλ πνπ ζηάιζεθαλ)
Test Case 10: APPROVED TRANSACTION (MASTERCARD)
΢ελάξην: Έγθξηζε ζπλαιιαγήο (ρσξίο δόζεηο) κε θάξηα Mastercard
Currency 978
Installments 0
CardType MasterCard ή UNKNOWN
ExpirationMonth 01
CVV2 123
ResultCode 0
ResponseCode 00

Test Case 11: APPROVED TRANSACTION (MAESTRO)
Πξνζνρή!
Ζ ρξήζε ησλ Maestro θαξηώλ επηηξέπεηαη κόλν εθόζνλ πξνεγείηαη ε 3D-
Secure δηαδηθαζία
΢ελάξην: Έγθξηζε ζπλαιιαγήο (ρσξίο δόζεηο) κε θάξηα Maestro
Currency 978
Installments 0
CardType Maestro ή UNKNOWN
ExpirationMonth 01
CVV2 123
StatusFlag 0
ResultCode 00

Test Case 12: APPROVED TRANSACTION (DINERS)
΢ελάξην: Έγθξηζε ζπλαιιαγήο (ρσξίο δόζεηο) κε θάξηα Diners
Currency 978
Installments 0
CardType DinersClub ή UNKNOWN
ExpirationMonth 01
CVV2 123
΢εκείσζε:
΢πλαιιαγέο κε Diners/Discover θάξηα ζηέιλνληαη κε
ηηκή «null» ζην «AuthInfo» element (πεξηέρνληαη νη
παξάκεηξνη Eci, Xid, Enrolled, PAResStatus,
SignatureVerification – βι. ελόηεηα 5).
ResultCode 0
ResponseCode 00

Test Case 13: APPROVED TRANSACTION (DISCOVER)
΢ελάξην: Έγθξηζε ζπλαιιαγήο (ρσξίο δόζεηο) κε θάξηα Discover
Currency 978
Installments 0
CardType DinersClub ή UNKNOWN
ExpirationMonth 01
CVV2 123
΢εκείσζε:
΢πλαιιαγέο κε Diners/Discover θάξηα ζηέιλνληαη κε
ηηκή «null» ζην «AuthInfo» element (πεξηέρνληαη νη
παξάκεηξνη Eci, Xid, Enrolled, PAResStatus,
ResultCode 0
ResponseCode 00

Test Case 14: APPROVED TRANSACTION (AMERICAN EXPRESS)
΢ελάξην: Έγθξηζε ζπλαιιαγήο (ρσξίο δόζεηο) κε θάξηα American Express
Currency 978
Installments 0
CardType AMEX ή UNKNOWN
ExpirationMonth 01
CVV2 1234
΢εκείσζε:
΢πλαιιαγέο κε American Express θάξηα ζηέιλνληαη
κε ηηκή «null» ζην «AuthInfo» element (πεξηέρνληαη
νη παξάκεηξνη Eci, Xid, Enrolled, PAResStatus,
ResultCode 0
ResponseCode 00

Test Case 15: APPROVED TRANSACTION (GBP)
Πξνζνρή!
Γηα θάζε δηαθνξεηηθό λόκηζκα απαηηείηαη δηαθνξεηηθό test θαη live account
΢ελάξην: Έγθξηζε ζπλαιιαγήο (ρσξίο δόζεηο) ζε λόκηζκα GBP
Currency 826
Installments 0
ExpirationMonth 01
CVV2 123
ResultCode 0
ResponseCode 00

Test Case 16: APPROVED TRANSACTION (USD)
Πξνζνρή!
Γηα θάζε δηαθνξεηηθό λόκηζκα απαηηείηαη δηαθνξεηηθό test θαη live account
΢ελάξην: Έγθξηζε ζπλαιιαγήο (ρσξίο δόζεηο) ζε λόκηζκα USD
Currency 840
Installments 0
ExpirationMonth 01
CVV2 123
ResultCode 0
ResponseCode 00

8. Απαηηήζεηο Αζθάιεηαο
΢ρεηηθά κε ηηο απαηηήζεηο αζθάιεηαο ηηο νπνίεο είλαη απαξαίηεην λα πιεξεί ην

ζύζηεκα ηεο επηρείξεζεο, ζα πξέπεη λα ιεθζνύλ ππόςε ηα παξαθάησ:
 ΢πληζηάηαη λα γίλεη ρξήζε client certification ώζηε ε Σξάπεδα Πεηξαηώο λα

πξαγκαηνπνηεί «authentication» θαη «authorization» ηεο εθαξκνγήο ηεο
επηρείξεζεο πνπ απνζηέιιεη ζπλαιιαγέο ζην Πεηξαηώο Paycenter.
 ΢ύκθσλα κε ηηο πξνδηαγξαθέο ησλ νξγαληζκώλ Visa/Mastercard, δελ

επηηξέπεηαη λα απνζεθεύνληαη ζην ζύζηεκα ηεο επηρείξεζεο θαλέλα από ηα
ζηνηρεία ησλ θαξηώλ (δειαδή αξηζκόο θάξηαο, εκεξνκελία ιήμεο, cvv2).
 Δάλ νη ζπλαιιαγέο γίλνληαη κέζσ site, ηόηε απαηηείηαη λα ρξεζηκνπνηείηαη

SSL encryption κε ηνπιάρηζηνλ 128-bit κέγεζνο θιεηδηνύ ζηε ζειίδα πνπ ν
ρξήζηεο εηζάγεη ηα ζηνηρεία ηεο θάξηαο ηνπ, ώζηε ηα ζηνηρεία ηεο θάξηαο
λα κεηαθέξνληαη κε αζθάιεηα.
΢εκείσζε:
Πξνθεηκέλνπ λα ζηαινύλ ηα ζηνηρεία ηνπ live account, ζα πξέπεη
λα έρεη γίλεη ρξήζε ηνπ SSL ζην live site ώζηε λα ειεγρζεί από ηελ
ηξάπεδα Πεηξαηώο.
 Ζ ρξήζε ssl ζηε ζειίδα εηζαγσγήο ζηνηρείσλ θάξηαο ζην site ηεο
επηρείξεζεο, πξέπεη λα είλαη εκθαλήο ζην ρξήζηε κέζσ ησλ ζρεηηθώλ
εηθνληδίσλ πνπ ρξεζηκνπνηνύληαη από ηνπο δηάθνξνπο browsers. Γηα ην
ιόγν απηό, ε ζειίδα εηζαγσγήο ησλ ζηνηρείσλ ηεο θάξηαο δελ κπνξεί λα
βξίζθεηαη κέζα ζε θαλελόο είδνπο Frame (FrameSet, IFrame) θαζώο δελ
εκθαλίδεηαη ε secure δηεύζπλζε ηεο ζπγθεθξηκέλεο ζειίδαο κε ηα
αληίζηνηρα ζύκβνια ησλ browser πνπ ππνδεηθλύνπλ ζην ρξήζηε ηελ
εγθπξόηεηα θαη αζθάιεηά ηεο. Αληίζεηα ζε κηα ηέηνηα πεξίπησζε,
εκθαλίδεηαη ε δηεύζπλζε ηεο parent ζειίδαο ηνπ Frame πνπ πηζαλόλ λα κελ
είλαη secure θαη δίλεη εζθαικέλε εληύπσζε ζηνλ ηειηθό ρξήζηε.
 Γηα ζπλαιιαγέο από site, ζην πεδίν ηνπ cvv2 ζα πξέπεη λα κελ είλαη
εκθαλείο νη ραξαθηήξεο θαηά ηελ πιεθηξνιόγεζή ηνπο από ην ρξήζηε
(π.ρ. λα εκθαλίδνληαη αζηεξάθηα ζηε ζέζε ηνπο).
9. Υξήζε Δηθνληδίσλ
΢ε πεξίπησζε πνπ νη ζπλαιιαγέο πξαγκαηνπνηνύληαη από site, είλαη απαξαίηεην λα

ρξεζηκνπνηεζνύλ – ζύκθσλα κε ηηο πξνδηαγξαθέο ησλ νξγαληζκώλ Visa θαη
Mastercard – ηα απαξαίηεηα εηθνλίδηα. Όιν ην ζρεηηθό πιηθό πεξηιακβάλεηαη ζην
αξρείν «icons.zip». ΢πγθεθξηκέλα:
Δηθνλίδηα ππνζηεξηδόκελσλ θαξηώλ
Σα εηθνλίδηα ησλ θαξηώλ πνπ ππνζηεξίδνληαη πεξηιακβάλνληαη κέζα ζην folder

(icons/CardsIcons) θαη είλαη ηα εμήο:
Visa (Visa.jpg)
Mastercard (Mastercard.jpg)
Maestro (Maestro.jpg)
Μόλν αλ γίλεηαη ρξήζε ηεο
δηαδηθαζίαο 3D-Secure
Δάλ επηπιένλ ππνζηεξίδνληαη θαη Diners/Discover ή/θαη American Express

θάξηεο, ηόηε ζα πξέπεη λα ζπκπεξηιεθζνύλ θαη ηα αληίζηνηρα εηθνλίδηα:
Diners (Diners.jpg)
Discover (Discover.jpg)
American Express (Amex.jpg)
Σα παξαπάλσ εηθνλίδηα ζα πξέπεη λα εκθαλίδνληαη ζηε ζειίδα πνπ ν ρξήζηεο

εηζάγεη ηα ζηνηρεία ηεο θάξηαο θαζώο θαη ζηελ αξρηθή ζειίδα ηνπ site.
Δηθνλίδηα δηαδηθαζίαο 3D-Secure ζηελ αξρηθή ζειίδα
΢ηελ αξρηθή ζειίδα ηνπ site θαζώο θαη ζηε ζειίδα πνπ αλαθέξεηαη ζε ζέκαηα
αζθάιεηαο (αλ ππάξρεη ηέηνηα ζειίδα), πξέπεη λα εκθαλίδνληαη ηα παξαθάησ
εηθνλίδηα:
Verified by Visa ππεξεζία:
Θα πξέπεη λα εκθαλίδεηαη ην εηθνλίδην:

(icons/VbV/vbv.gif)
ην νπνίν ζα είλαη link πνπ ζα νδεγεί ζε λέν παξάζπξν ζην URL:
 Διιεληθή έθδνζε:
https://paycenter.piraeusbank.gr/redirection/Content/HTML/3DSecure_el.html
 Αγγιηθή έθδνζε:
https://paycenter.piraeusbank.gr/redirection/Content/HTML/3DSecure_en.html
MasterCard SecureCode ππεξεζία:
Θα πξέπεη λα εκθαλίδεηαη έλα από ηα εηθνλίδηα πνπ πεξηιακβάλνληαη ζην folder

icons/SecureCode ην νπνίν ζα είλαη link πνπ ζα νδεγεί ζε λέν παξάζπξν ζην
URL:
 Διιεληθή έθδνζε:
https://paycenter.piraeusbank.gr/redirection/Content/HTML/3DSecure_el.html
 Αγγιηθή έθδνζε:
https://paycenter.piraeusbank.gr/redirection/Content/HTML/3DSecure_en.html
Δηθνλίδηα δηαδηθαζίαο 3D-Secure ζηε ζειίδα εηζαγσγήο ζηνηρείσλ

θάξηαο
΢ηε ζειίδα πνπ ν ρξήζηεο εηζάγεη ηα ζηνηρεία ηεο θάξηαο ηνπ, ζα πξέπεη λα
εκθαλίδνληαη ηα παξαθάησ εηθνλίδηα:
Verified by Visa ππεξεζία:
Θα πξέπεη λα εκθαλίδεηαη ην παξαθάησ εηθνλίδην (ρσξίο λα είλαη link):
(icons/VbV/vbv.jpg)
MasterCard SecureCode ππεξεζία:
Θα πξέπεη λα εκθαλίδεηαη έλα από ηα εηθνλίδηα πνπ πεξηιακβάλνληαη ζην

folder icons/SecureCode (ρσξίο λα είλαη link).
Λνγόηππν Σξάπεδαο Πεηξαηώο
Πξναηξεηηθά, κπνξεί λα εκθαλίδεηαη ζην site ην ινγόηππν ηεο Σξάπεδαο Πεηξαηώο.

Σα ζρεηηθά εηθνλίδηα πεξηιακβάλνληαη ζην folder icons/PiraeusBank.
10. ΢πκβνπιέο
Παξαθάησ πεξηιακβάλνληαη θάπνηεο παξαηεξήζεηο – ζπκβνπιέο νη νπνίεο πξέπεη

λα ιεθζνύλ ππόςε:
Κία πξνέγθξηζε κπνξεί λα νινθιεξσζεί από ηελ επηρείξεζε (είηε κέζσ ηνπ
Paycenter AdminTool είηε κέζσ θιήζεο ηνπ Transaction Web Service)
εληόο ηνπ πιήζνπο εκεξώλ πνπ νξίδνληαη από ηελ παξάκεηξν
«ExpirePreauth» (κέγηζηε ηηκή 30 εκέξεο). Κεηά ην δηάζηεκα απηό, ε
πξνέγθξηζε ιήγεη θαη δελ είλαη δπλαηό λα νινθιεξσζεί.
Δίλαη δπλαηό λα γίλεη επηζηξνθή ρξεκάησλ κέζσ ηεο εθαξκνγήο AdminTool

πνπ παξέρεηαη ζηελ επηρείξεζε ή κέζσ θιήζεο ηνπ Transaction Web
Service. Ζ επηζηξνθή είλαη επηηξεπηή κέρξη ην πνιύ 180 εκέξεο από ηελ
εκεξνκελία ηεο αληίζηνηρεο ρξέσζεο.
΢ύκθσλα κε ηηο πξνδηαγξαθέο ησλ νξγαληζκώλ Visa/Mastercard, δελ

επηηξέπεηαη λα απνζεθεύνληαη ζην ζύζηεκα ηεο επηρείξεζεο θαλέλα από ηα
ζηνηρεία ησλ θαξηώλ (δειαδή αξηζκόο θάξηαο, εκεξνκελία ιήμεο, cvv2).
΢ηε δηαδηθαζία πηζηνπνίεζεο θαηόρνπ θάξηαο («3d-secure»), δελ πξέπεη

πνηέ λα ζηέιλεηαη ηηκή ζηελ παξάκεηξν «Installment» ζην
«cmpi_lookup» κήλπκα, δηόηη απηή ε ηηκή δελ αθνξά ην πιήζνο άηνθσλ
δόζεσλ ηεο ζπλαιιαγήο θαη δελ έρεη ηζρύ.
Ζ παξάκεηξνο «Password» ζην «Transaction Web Service» (βι. ελόηεηα

5), ζα πξέπεη λα ζηέιλεηαη θξππηνγξαθεκέλε κε ηνλ MD5 hashing
αιγόξηζκν.
Ζ παξάκεηξνο «MerchantReference» ζην «Transaction Web Service»

πξέπεη λα είλαη κνλαδηθή γηα θάζε επηηπρή ζπλαιιαγή αγνξάο ή
πξνέγθξηζεο. Βέβαηα, αλ κία ζπλαιιαγή απνηύρεη, κπνξεί λα μαλαζηαιεί
ζπλαιιαγή κε ην ίδην «MerchantReference» εθόζνλ επαλαιεθζεί ε
δηαδηθαζία πηζηνπνίεζεο θαηόρνπ θάξηαο (γηα on-line ζπλαιιαγέο από
site).
Δίλαη ζεκαληηθό ε παξάκεηξνο «MerchantReference» λα πεξηέρεη ηηκή

πνπ έρεη ηδηαίηεξν λόεκα θαη είλαη γλσζηή ζηελ επηρείξεζε (π.ρ. αξηζκόο
παξαγγειίαο, αξηζκόο ζπκβνιαίνπ θιπ). Ζ ηηκή απηή πνπ εθθξάδεη
κνλαδηθά θάζε επηηπρή ζπλαιιαγή, εκθαλίδεηαη ζην δηαρεηξηζηηθό εξγαιείν
«AdminTool» πνπ παξέρεη ε ηξάπεδα Πεηξαηώο ζηηο επηρεηξήζεηο γηα ηελ
παξαθνινύζεζε ησλ ζπλαιιαγώλ ηνπο, κέζα από ην νπνίν νη ππεύζπλνη
ησλ επηρεηξήζεσλ έρνπλ ηε δπλαηόηεηα λα αλαδεηνύλ ζπλαιιαγέο κε
θξηηήξην ηελ ηηκή ηνπ «MerchantReference».
Δάλ ζηαιεί ζπλαιιαγή κε «MerchantReference» πνπ έρεη ήδε

ρξεζηκνπνηεζεί ζε επηηπρή ζπλαιιαγή, δελ πξαγκαηνπνηείηαη λέα
ζπλαιιαγή θαη επηζηξέθεηαη απάληεζε κε ResponseCode = «11» θαη ηα
ζηνηρεία ηεο ήδε εθηειεζκέλεο ζπλαιιαγήο (βι. ελόηεηα 6).
Γηα ηελ θαιύηεξε ππνζηήξημε ησλ επηρεηξήζεσλ από ηελ ηξάπεδα Πεηξαηώο,
ζα πξέπεη ε παξάκεηξνο «SupportReferenceID» θάζε πξνζπάζεηαο λα
απνζεθεύεηαη θαη λα είλαη δηαζέζηκε ζηνπο ππεύζπλνπο ηεο επηρείξεζεο
ώζηε λα κπνξεί λα ρξεζηκνπνηεζεί θαηά ηελ επηθνηλσλία κε ηελ ηξάπεδα
Πεηξαηώο γηα ηπρόλ επίιπζε πξνβιεκάησλ. Ζ ίδηα παξάκεηξνο πξέπεη λα
απνζηέιιεηαη από ηνπο ηερληθνύο ζηελ ηξάπεδα Πεηξαηώο ζε πεξίπησζε
πξνβιεκάησλ θαηά ηε δηάξθεηα ησλ δνθηκαζηηθώλ ζπλαιιαγώλ.
Οη άηνθεο δόζεηο ππνζηεξίδνληαη κόλν ζε νξηζκέλεο θάξηεο ειιεληθώλ

ηξαπεδώλ (εμαξηάηαη από ην BIN, δειαδή ηα πξώηα 6 ςεθία ηνπ αξηζκνύ
ηεο θάξηαο). Ζ Σξάπεδα Πεηξαηώο παξέρεη ην «BIN Web Service» κέζσ
ηνπ νπνίνπ κπνξεί λα ειεγρζεί αλ κία θάξηα ππνζηεξίδεη δόζεηο ή όρη ρσξίο
λα πξαγκαηνπνηεζεί ζπλαιιαγή. ΢ε πεξίπησζε ελδηαθέξνληνο, ζα πξέπεη
λα δεηεζνύλ από ηελ Σξάπεδα Πεηξαηώο νη πξνδηαγξαθέο γηα ηελ θιήζε
ηνπ.
΢ε πεξίπησζε πνπ δηαθνπεί ε επηθνηλσλία κε ην «Πεηξαηώο Paycenter» θαη

δε ιεθζεί από ην ζύζηεκα ηεο επηρείξεζεο ε απάληεζε γηα κία ζπλαιιαγή,
κπνξεί λα ζηαιζεί request αθύξσζεο ηεο ζπλαιιαγήο (RequestType =
«REFUND») ζηέιλνληαο ηηκή ζηελ παξάκεηξν «MerchantReference» αληί
ζηελ παξάκεηξν «TransactionReferenceID». Ζ ιεηηνπξγηθόηεηα απηή
παξέρεηαη κόλν γηα αθπξώζεηο ζπλαιιαγώλ (δειαδή αθπξώζεηο
ζπλαιιαγώλ πνπ αλήθνπλ ζε αλνηρηό παθέην).
11. Implementation Checklist
Α/Α TASK
1. ΤΠΟΓΡΑΦΗ ΢ΤΜΒΑ΢Η΢
Τπνγξαθή ζύκβαζεο ζπλεξγαζίαο γηα ρξήζε ηεο ππεξεζίαο «Web
Service» κεηαμύ ηεο επηρείξεζεο θαη ηεο Σξάπεδαο Πεηξαηώο.
2. ΣΔΥΝΙΚΗ ΤΛΟΠΟΙΗ΢Η
Τινπνίεζε:
 Γηαδηθαζίαο πηζηνπνίεζεο θαηόρνπ θάξηαο γηα on-line ζπλαιιαγέο
κε θάξηεο Visa, Mastercard θαη Maestro κέζσ site («3d-secure» -
βι. ελόηεηα 4)
 Ινγηζκηθνύ θιήζεο ηνπ «Transaction Web Service»
3. ΑΠΟ΢ΣΟΛΗ ΠΛΗΡΟΦΟΡΙΧΝ ΓΙΑ TEST ACCOUNT

Απνζηνιή ζηελ Σξάπεδα Πεηξαηώο ησλ απαξαίηεησλ πιεξνθνξηώλ γηα ηε
δεκηνπξγία test account (βι. ελόηεηα 3)
4. ΠΡΑΓΜΑΣΟΠΟΙΗ΢Η ΓΟΚΙΜΑ΢ΣΙΚΧΝ ΢ΤΝΑΛΛΑΓΧΝ

 Απνζηνιή από ηελ Σξάπεδα Πεηξαηώο ησλ ζηνηρείσλ ηνπ test
account:
 3d-secure test account (γηα ηε δηαδηθαζία πηζηνπνίεζεο
θαηόρνπ θάξηαο – κόλν γηα ζπζηήκαηα κε on-line
ζπλαιιαγέο):
 ProcessorId
 MerchantId
 TransactionPwd
 Paycenter test account (γηα ηελ απνζηνιή ζπλαιιαγήο

κέζσ ηνπ «Transaction Web Service»):
 AcquirerID
 MerchantID
 PosID
 User
 Password
 ChannelType
 Κόλν γηα ζπζηήκαηα κε on-line ζπλαιιαγέο από site:

Πξαγκαηνπνίεζε όισλ ησλ test cases ηεο πιαηθόξκαο ηεο
Cardinal (βι. ελόηεηα 4).
 Πξαγκαηνπνίεζε δνθηκαζηηθώλ ζπλαιιαγώλ κε ην «Transaction

Web Service» (βι. ελόηεηα 7).
5. ΥΡΗ΢Η ΔΙΚΟΝΙΓΙΧΝ
Γηα ζπζηήκαηα πνπ απνζηέιινπλ ζπλαιιαγέο κέζσ site:
Αλάξηεζε απαξαίηεησλ εηθνληδίσλ ζην site ηεο επηρείξεζεο (βι. ελόηεηα
9)
6. ΟΛΟΚΛΗΡΧ΢Η ΓΟΚΙΜΑ΢ΣΙΚΧΝ ΢ΤΝΑΛΛΑΓΧΝ
 Δλεκέξσζε Σξάπεδαο Πεηξαηώο γηα ηελ επηηπρή νινθιήξσζε ησλ
δνθηκαζηηθώλ ζπλαιιαγώλ θαη ηε ρξήζε ησλ εηθνληδίσλ θαη ηνπ
ssl θαη απνζηνιή ζηνηρείσλ ησλ δνθηκαζηηθώλ ζπλαιιαγώλ γηα
έιεγρν από ηελ Σξάπεδα. ΢πγθεθξηκέλα, πξέπεη λα ζηαινύλ:
 Ζ ηηκή ηεο παξακέηξνπ «OrderNumber» ηνπ
«cmpi_lookup» κελύκαηνο γηα όια ηα test cases ηεο
πιαηθόξκαο ηεο Cardinal (κόλν γηα ζπζηήκαηα on-line
ζπλαιιαγώλ κέζσ site).
 Ζ ηηκή ηνπ «SupportReferenceID» ηεο απάληεζεο ηνπ
Paycenter γηα ηα test cases ηεο Cardinal όπνπ ζηάιζεθε
ζπλαιιαγή.
 Έιεγρνο δνθηκαζηηθώλ ζπλαιιαγώλ από ηελ ηξάπεδα Πεηξαηώο θαη

ελεκέξσζε ηερληθνύ ππεύζπλνπ γηα ην απνηέιεζκα εληόο κίαο
εβδνκάδαο.
 Απνζηνιή ζηελ Σξάπεδα Πεηξαηώο ηεο IP address ηνπ server από

ηνλ νπνίν ζα απνζηέιινληαη πξαγκαηηθέο ζπλαιιαγέο (ζύζηεκα
παξαγσγήο ηεο επηρείξεζεο).
 Απνζηνιή ζηελ Σξάπεδα Πεηξαηώο ελόο email ηεο επηρείξεζεο γηα

παξαιαβή email πνπ αθνξνύλ ην Paycenter.
 Δλεκέξσζε επηρείξεζεο από ηνλ ηερληθό ππεύζπλν γηα ηελ

νινθιήξσζε ησλ δνθηκαζηηθώλ ζπλαιιαγώλ ώζηε ε επηρείξεζε λα
θξνληίζεη γηα ηελ ππνγξαθή ηεο ζύκβαζεο πξνθεηκέλνπ λα
παξαρζεί ην live account.
7. ΛΗΦΗ LIVE ACCOUNT

 Απνζηνιή από ηελ Σξάπεδα Πεηξαηώο ησλ ζηνηρείσλ ηνπ live
account:
 3d-secure live account (κόλν γηα ζπζηήκαηα on-line
ζπλαιιαγώλ κέζσ site):
 ProcessorId
 MerchantId
 TransactionPwd
 Paycenter live account:

 AcquirerID
 MerchantID
 PosID
 User
 Password
 ChannelType
 Αληηθαηάζηαζε ησλ ζηνηρείσλ ηνπ test account κε ηα ζηνηρεία ηνπ

live account.
 Αληηθαηάζηαζε ηνπ test URL ηεο 3d-secure δηαδηθαζίαο κε ην live:

o 3d-secure δηαδηθαζία:
https://centinel.piraeusbank.fdsecure.com/maps/txns.asp
΢εκείσζε:
Σν URL ηνπ Transaction Web Service είλαη ην ίδην ηόζν γηα
δνθηκαζηηθέο όζν θαη γηα πξαγκαηηθέο ζπλαιιαγέο:
https://paycenter.piraeusbank.gr/services/paymentgateway.asmx
Παξάξηεκα 1
Παξαθάησ παξνπζηάδνληαη νη πην ζπρλέο ηηκέο ησλ παξακέηξσλ «ResultCode» (δει. ησλ ηερληθώλ πξνβιεκάησλ πνπ κπνξεί λα
πξνθύςνπλ) θαη «ResponseCode» (δει. ησλ πην ζπρλώλ απαληήζεσλ πνπ ζηέιλνληαη από ηηο εθδόηξηεο ηξάπεδεο).
΢ΤΥΝΔ΢ ΣΙΜΔ΢ ResultCode

ResultCode ResultDescription Δπεμήγεζε Δλέξγεηα
1 An error occured. Please check Γεληθό κήλπκα ιάζνπο πνπ Λέα πξνζπάζεηα αξγόηεξα ώζηε λα έρεη
your data or else contact εκθαλίδεηαη όηαλ ππάξρεη απνθαηαζηαζεί ην πξόβιεκα
Winbank PayCenter ηερληθό πξόβιεκα ζην
administrator Paycenter.
100 Authentication Error Έρεη ζηαιζεί ιαλζαζκέλε ηηκή Ο ηερληθόο ηεο επηρείξεζεο πξέπεη λα
ζηελ παξάκεηξν «Username» θάλεη ηηο απαξαίηεηεο δηνξζώζεηο ώζηε λα
θαη/ή «Password». ζηαιζνύλ ζσζηέο ηηκέο.
130 Field «x» contains invalid Σν πεδίν «x» πεξηέρεη κε Ο ηερληθόο ηεο επηρείξεζεο πξέπεη λα
characters απνδεθηνύο ραξαθηήξεο θάλεη ηηο απαξαίηεηεο δηνξζώζεηο ώζηε λα
απνζηέιιεηαη ζσζηή ηηκή ζην πεδίν «x».
151 Check that field «x» contains Γελ ππάξρεη ηηκή ζην πεδίν «x». Ο ηερληθόο ηεο επηρείξεζεο πξέπεη λα
data θάλεη ηηο απαξαίηεηεο δηνξζώζεηο ώζηε λα
απνζηέιιεηαη ηηκή ζην πεδίν «x».
215 AMEX cards require 4 digit cvv2 Αθνξά ζπλαιιαγή κε θάξηα Λα μαλαζηαιζεί ε ζπλαιιαγή κε ην
American Express. To Cvv2 ζα ζσζηό Cvv2.
έπξεπε λα απνηειείηαη από 4
ςεθία.
216 Wrong cvv2 Κε απνδεθηή ηηκή ζηελ Ο ηερληθόο ηεο επηρείξεζεο πξέπεη λα
παξάκεηξν ηνπ cvv2 («Cvv2»), θάλεη ηηο απαξαίηεηεο δηνξζώζεηο ώζηε λα
π.ρ. ραξαθηήξεο. απνζηέιιεηαη απνδεθηή ηηκή ζην cvv2
(π.ρ. λα είλαη επηηξεπηνί κόλν αξηζκεηηθνί
ραξαθηήξεο) ή ν θαξηνύρνο λα
επαλαιάβεη ηε ζπλαιιαγή απνζηέιινληαο
ην ζσζηό Cvv2.
50x (π.ρ. 500, Communication Error Πξόβιεκα επηθνηλσλίαο κε ην Λέα πξνζπάζεηα αξγόηεξα ώζηε λα έρεη
501 θιπ) ζύζηεκα επεμεξγαζίαο ησλ απνθαηαζηαζεί ην πξόβιεκα
ζπλαιιαγώλ.
981 Invalid Card number/Exp Δηζαγσγή ιαλζαζκέλσλ Λα ζπκπιεξσζνύλ ζσζηά ηα ζηνηρεία ηεο
Month/Exp Year ζηνηρείσλ θάξηαο (π.ρ. ιάζνο θάξηαο
αξηζκόο, ιάζνο ηύπνο θάξηαο
παξειζνληηθή εκ/λία ιήμεο) ή
θάξηαο πνπ δελ ππνζηεξίδεηαη
από ην ζύζηεκα.
1006 Unknown BIN Αθνξά ζπλαιιαγή κε δόζεηο. Ζ Λα ρξεζηκνπνηεζεί άιιε θάξηα ή λα
θάξηα ηνπ ρξήζηε δε ζπκκεηέρεη επαλαιεθζεί ε ζπλαιιαγή ρσξίο δόζεηο
ζην πξόγξακκα ησλ άηνθσλ
δόζεσλ ηεο Σξάπεδαο Πεηξαηώο.
1007 Merchant does not support Αθνξά ζπλαιιαγή κε δόζεηο. To Λα ρξεζηκνπνηεζεί άιιε θάξηα ή λα
given bin bin ηεο θάξηαο (δει. ηα πξώηα 6 επαλαιεθζεί ε ζπλαιιαγή ρσξίο δόζεηο
ςεθία) δελ κπνξεί λα
ρξεζηκνπνηεζεί ζε ζπλαιιαγή κε
δόζεηο ζηε ζπγθεθξηκέλε
1010 Wrong original transaction Αθνξά ζπλαιιαγή νινθιήξσζεο Λα ειεγρζεί ε αξρηθή ζπλαιιαγή θαη λα
πξνέγθξηζεο (SETTLEMENT), ζηαιζεί ε ζσζηή ηηκή ζην
αθύξσζεο πξνέγθξηζεο «TransactionReferenceID».
(VOIDREQUEST) ή επηζηξνθήο
πνζνύ (REFUND). Σν request
απνξξίθζεθε γηαηί δελ ππάξρεη
επηηπρήο αξρηθή ζπλαιιαγή γηα
ηελ νπνία δεηήζεθε νινθιήξσζε
ή αθύξσζε ηεο πξνέγθξηζεο ή
επηζηξνθή.
1012 Original transaction already Αθνξά ζπλαιιαγή νινθιήξσζεο Λα ειεγρζεί κέζσ ηνπ AdminTool αλ ε
settled, or being settled πξνέγθξηζεο («SETTLEMENT»). πξνέγθξηζε έρεη όλησο νινθιεξσζεί.
Εεηήζεθε νινθιήξσζε γηα
πξνέγθξηζε ε νπνία έρεη ήδε
νινθιεξσζεί ή ήδε βξίζθεηαη
ππό επεμεξγαζία νινθιήξσζε
πξνέγθξηζεο γηα ηε
ζπγθεθξηκέλε ζπλαιιαγή.
1014 Refunding amount cannot Αθνξά ζπλαιιαγή επηζηξνθήο Θα πξέπεη λα επαλαιεθζεί ε επηζηξνθή
exceed remaining amount of («REFUND»). Σν πνζό κε ην ζσζηό πνζό.
the original transaction επηζηξνθήο ππεξβαίλεη ην πνζό
ηεο αξρηθήο ζπλαιιαγήο ΢εκείσζε:
ρξέσζεο. Δίλαη επηηξεπηό λα γίλνπλ πνιιέο
κεξηθέο επηζηξνθέο αξθεί ην
άζξνηζκα ησλ πνζώλ όισλ ησλ
επηζηξνθώλ λα κελ ππεξβαίλεη ην
πνζό ηεο αξρηθήο ζπλαιιαγήο
ρξέσζεο.
1017 Preorder date has expired Αθνξά ζπλαιιαγή νινθιήξσζεο Θα πξέπεη λα πξαγκαηνπνηεζεί λέα
πξνέγθξηζεο («SETTLEMENT»). πξνέγθξηζε.
Ζ νινθιήξσζε δελ είλαη εθηθηή
γηαηί ε πξνέγθξηζε έρεη ιήμεη.
1019 Too many installments asked Σν πιήζνο δόζεσλ πνπ Λα ρξεζηκνπνηεζεί κηθξόηεξν πιήζνο
ρξεζηκνπνηήζεθε είλαη δόζεσλ
κεγαιύηεξν από ην κέγηζην
επηηξεπηό γηα ηε ζπγθεθξηκέλε
1026 Merchant does not support Σν request πεξηιακβάλεη δόζεηο Λα πξαγκαηνπνηεζεί επηθνηλσλία κε ηελ
instalments αιιά δελ ππνζηεξίδνληαη ζηε Σξάπεδα Πεηξαηώο ώζηε λα
ζπγθεθξηκέλε επηρείξεζε. ελεξγνπνηεζνύλ νη δόζεηο.
1034 Terminal does not support Ζ ζπλαιιαγή ζηάιζεθε κε κε Λα ειεγρζεί αλ ζηάιζεθε ν ζσζηόο ηύπνο
given card type ππνζηεξηδόκελν ηύπν θάξηαο. θάξηαο θαη λα γίλεη επηθνηλσλία κε ηελ
1040, 1041 «Error validating IP address. Ζ ζπλαιιαγή ζηάιζεθε από IP Λα ειεγρζεί ε IP address από ηελ νπνία
Contact sysadmin.» (1040), address δηαθνξεηηθή από απηή ζηέιλνληαη ηα requests θαη αλ ρξεηάδεηαη
πνπ έρεη δεισζεί από ηνλ λα αιιαρζεί, λα γίλεη επηθνηλσλία κε ηελ
«Invalid IP address.» (1041) ηερληθό ππεύζπλν. Σξάπεδα Πεηξαηώο.
1042 Refund maximum allowed Έγηλε πξνζπάζεηα γηα επηζηξνθή Λα πξαγκαηνπνηεζεί επηθνηλσλία κε ηελ
period exceeded πνζνύ (REFUND) κεηά ην Σξάπεδα Πεηξαηώο
επηηξεπηό δηάζηεκα ησλ 180
εκεξώλ.
1045 Duplicate transaction Αθνξά ζπλαιιαγή αγνξάο ή Λα γίλεη λέα ζπλαιιαγή αξγόηεξα ώζηε
references are not allowed πξνέγθξηζεο. Ζ ζπλαιιαγή λα έρεη νινθιεξσζεί ε ππν-επεμεξγαζία
ζηάιζεθε κε ηηκή ζην ζπλαιιαγή. Αλ ε πξώηε ζπλαιιαγή πήξε
«MerchantReference» ε νπνία ηειηθά έγθξηζε, ζα επηζηξαθεί ην error
ρξεζηκνπνηείηαη ζε άιιε 1048, δηαθνξεηηθά ζα γίλεη θαλνληθά ε
ζπλαιιαγή πνπ ηε ζηηγκή εθείλε λέα ζπλαιιαγή. Δλαιιαθηηθά, κπνξεί λα
βξίζθεηαη ππό επεμεξγαζία. ειεγρζεί κέζσ ηνπ AdminTool αλ ηειηθά
εγθξίζεθε ε αξρηθή, ππν-επεμεξγαζία
ζπλαιιαγή.
1072 Pack is still closing Γίλεηαη ε δηαδηθαζία εθθαζάξηζεο Λέα πξνζπάζεηα αξγόηεξα ώζηε λα
ησλ ζπλαιιαγώλ ηνπ ηξέρνληνο νινθιεξσζεί ην θιείζηκν ηνπ παθέηνπ
παθέηνπ (θιείζηκν παθέηνπ)
θαηά ηε δηάξθεηα ηεο νπνίαο δελ
είλαη δπλαηή ε επεμεξγαζία
ζπλαιιαγώλ.
1802 Wrong amount value Κε απνδεθηή ηηκή ζηελ Ο ηερληθόο ηεο επηρείξεζεο πξέπεη λα
παξάκεηξν ηνπ πνζνύ θάλεη ηηο απαξαίηεηεο δηνξζώζεηο ώζηε λα
(«Amount»), π.ρ. κεδεληθό απνζηέιιεηαη απνδεθηή ηηκή ζην πνζό.
πνζό.
7001 <Κωδικός ηοσ anti-fraud Ζ ζπλαιιαγή απνξξίθζεθε Πξνηξνπή ηνπ ρξήζηε λα δνθηκάζεη κε
κανόνα ποσ ενεργοποιήθηκε> ιόγσ anti-fraud ειέγρσλ πνπ άιιν ηξόπν πιεξσκήο ή άιιε θάξηα.
πξαγκαηνπνηήζεθαλ. ΢ηελ
παξάκεηξν «ResultDescritpion» Πξνζνρή!
επηζηξέθεηαη ν θσδηθόο ηνπ Ο ηειηθόο ρξήζηεο δε ζα πξέπεη λα
θαλόλα πνπ ελεξγνπνηήζεθε. Ο ελεκεξώλεηαη όηη ε ζπλαιιαγή
θσδηθόο «0», αθνξά απόξξηςε απνξξίθζεθε ιόγσ anti-fraud
ιόγσ εκθάληζεο ηεο θάξηαο ζε ειέγρσλ.
black list. Αλ γίλεηαη ρξήζε
εηδηθώλ θαλόλσλ γηα ηελ
επηρείξεζε, ε Πεηξαηώο ζα
παξέρεη ηνπο θσδηθνύο ησλ
εηδηθώλ θαλόλσλ.
΢ΤΥΝΔ΢ ΣΙΜΔ΢ ResponseCode

ResponseCode ResponseDescription Δπεμήγεζε Δλέξγεηα Έγθξηζε
05 Declined Ζ ζπλαιιαγή απνξξίθζεθε Δπηθνηλσλία θαηόρνπ Όρη
από ηελ εθδόηξηα ηξάπεδα θάξηαο κε ηελ
Σξάπεδα ηνπ ή ρξήζε
άιιεο θάξηαο
34 Lost card Ζ ζπλαιιαγή απνξξίθζεθε Δπηθνηλσλία θαηόρνπ Όρη
43 Stolen card,pick-up από ηελ εθδόηξηα ηξάπεδα θάξηαο κε ηελ
54 Expired card Ζ θάξηα έρεη ιήμεη θαη δελ Υξήζε άιιεο θάξηαο Όρη
έρεη αλαλεσζεί
62 Restricted Card Ζ ζπλαιιαγή απνξξίθζεθε Δπηθνηλσλία θαηόρνπ Όρη
92 Declined Πξόβιεκα επηθνηλσλίαο κε Λα πξαγκαηνπνηεζεί Όρη
ηνλ νξγαληζκό (Visa, λέα πξνζπάζεηα
Mastercard θιπ) αξγόηεξα
Ι2 Installment amount bellow allowed Αθνξά ζπλαιιαγή κε Λα επαλαιεθζεί ε Όρη
minimum δόζεηο θαη ε αμία ηεο θάζε ζπλαιιαγή κε
δόζεο είλαη κηθξόηεξε από ιηγόηεξεο δόζεηο
ηελ ειάρηζηε επηηξεπηή
ηηκή
΢εκείσζε:
Δίλαη δπλαηόλ λα επηζηξαθνύλ θαη άιιεο ηηκέο εθηόο από απηέο πνπ αλαθέξνληαη ζηνπο παξαπάλσ πίλαθεο.
Παξάξηεκα 2
Οη θσδηθνί ησλ ππνζηεξηδόκελσλ λνκηζκάησλ είλαη νη παξαθάησ:
Κσδηθόο Ννκίζκαηνο Νόκηζκα

008 ALBANIAN LEK (ALL)
036 AUSTRALIAN DOLLAR (AUD)
124 CANADIAN DOLLAR (CAD)
156 CHINESE YUAN (CNY)
191 CROATIAN KUNA (HRK)
203 CZECH KORUNA (CZK)
208 DANISH KRONE (DKK)
356 INDIAN RUPEE (INR)
376 ISRAELI NEW SHEQEL (ILS)
578 NORWEGIAN KRONE (NOK)
643 RUSSIAN ROUBLE (RUB)
752 SWEDISH KRONA (SEK)
756 SWISS FRANC (CHF)
784 UNITED ARAB EMIRATES DIRHAM (AED)
818 EGYPTIAN POUND (EGP)
826 POUND STERLING (GBP)
840 US DOLLAR (USD)
941 SERBIAN DINAR (RSD)
946 ROMANIAN LEU (RON)
949 TURKISH LIRA (TRY)
975 BULGARIAN LEV (BGN)
978 EURO (EUR)
980 UKRAINIAN HRYVNIA (UAH)
985 POLISH ZLOTY (PLN)
986 BRAZILIAN REAL (BRL)
Γισζζάξη
3d-secure Σν όλνκα ηνπ πξσηνθόιινπ πνπ ρξεζηκνπνηείηαη

από ηηο ππεξεζίεο πηζηνπνίεζεο θαηόρνπ θάξηαο
«Verified by Visa» θαη «Mastercard SecureCode».
Acquirer Οξγαληζκόο πνπ δίλεη ηε δπλαηόηεηα ζηηο
επηρεηξήζεηο λα δηεθπεξαηώλνπλ ζπλαιιαγέο κε
θάξηεο. ΢ηε ζπγθεθξηκέλε πεξίπησζε, είλαη ε
BIN Σα πξώηα 6 ςεθία ηνπ αξηζκνύ κηαο θάξηαο πνπ
θαζνξίδνπλ ηελ εθδόηξηα Σξάπεδα.
Live account Ο ινγαξηαζκόο ηεο επηρείξεζεο κέζσ ηνπ νπνίνπ
εθηεινύληαη πξαγκαηηθέο ζπλαιιαγέο. Απνηειείηαη
από ηα αθόινπζα ζηνηρεία:
 3d-secure account (γηα ηε δηαδηθαζία
πηζηνπνίεζεο θαηόρνπ θάξηαο – κόλν γηα
ζπζηήκαηα κε on-line ζπλαιιαγέο):
 ProcessorId
 MerchantId
 TransactionPwd
 Paycenter account (γηα ηελ απνζηνιή

ζπλαιιαγήο κέζσ ηνπ «Transaction Web
Service»):
 AcquirerID
 MerchantID
 PosID
 User
 Password
 ChannelType
Mastercard Ζ «ππεξεζία πηζηνπνίεζεο θαηόρνπ θάξηαο» πνπ
SecureCode παξέρεηαη από ηε Mastercard.
Merchant id Ο «κωδικός εμπόροσ» πνπ αληηζηνηρεί ζηελ
Pos id Ο «κωδικός ηερμαηικού» – ην ζεκείν πώιεζεο –
πνπ αληηζηνηρεί ζηελ επηρείξεζε (Point Of Sale).
Test account Γνθηκαζηηθόο ινγαξηαζκόο πνπ παξέρεηαη από ηελ
Σξάπεδα Πεηξαηώο κέζσ ηνπ νπνίνπ
πξαγκαηνπνηνύληαη δνθηκαζηηθέο ζπλαιιαγέο.
Απνηειείηαη από ηα ίδηα ζηνηρεία πνπ έρεη θαη ην
«live account» αιιά έρεη δηαθνξεηηθέο ηηκέο.
Transaction Web SOAP Web Service ηεο Σξάπεδαο Πεηξαηώο κέζσ
Service ηνπ νπνίνπ ζηέιλνληαη νη ζπλαιιαγέο ζην
«Πεηξαηώο Paycenter».
Verified by Visa Ζ «ππεξεζία πηζηνπνίεζεο θαηόρνπ θάξηαο» πνπ
παξέρεηαη από ηε Visa.
Πεηξαηώο Paycenter Σν ζύζηεκα ειεθηξνληθώλ πιεξσκώλ ηεο
Σξάπεδαο Πεηξαηώο.

Web Service Manual Ver 1.0.6 El

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Web Service Manual Ver 1.0.6 El

Uploaded by

Copyright:

Available Formats

Ιζηνξηθό Αιιαγώλ

Ηκεξνκελία Έθδνζε Αιιαγέο

Ζ ιύζε «Web Service» ηεο ππεξεζίαο «Πεηξαηώο Paycenter» ηεο Σξάπεδαο

Σα ζηνηρεία ηεο ζπλαιιαγήο απνζηέιινληαη ζην ζύζηεκα ειεθηξνληθώλ πιεξσκώλ

Οη θάξηεο πνπ ππνζηεξίδνληαη από ην «Πεηξαηώο Paycenter» είλαη νη εμήο:

Δπίζεο, εθόζνλ ε ζπλεξγαζία κε ηελ επηρείξεζε πεξηιακβάλεη θαη Diners/Discover

΢ηηο ελόηεηεο πνπ αθνινπζνύλ πεξηγξάθνληαη αλαιπηηθά πιεξνθνξίεο γηα ηα εμήο:

 Δλόηεηα 2  Γεληθή Αξρηηεθηνληθή:

 Δλόηεηα 3  ΢ηνηρεία γηα ηε Γεκηνπξγία Test Account:

 Δλόηεηα 4  Πηζηνπνίεζε Καηόρνπ Κάξηαο («3d-secure»):

 Δλόηεηα 5  Paycenter Transaction Web Service:

 Δλόηεηα 7  Transaction Web service Test Cases:

 Δλόηεηα 8  Υξήζε Δηθνληδίσλ:

 Δλόηεηα 10  Implementation Checklist:

΢ην παξαθάησ δηάγξακκα απεηθνλίδεηαη ε γεληθή αξρηηεθηνληθή ηεο ππεξεζίαο

Διάγραμμα 1: Γενική αρτιηεκηονική

Γηα λα πξαγκαηνπνηεζεί κία ζπλαιιαγή κε θάξηα Visa, Mastercard ή Maestro, ην

Οη πιεξνθνξίεο πνπ πξέπεη λα ζηαινύλ ζηελ Σξάπεδα Πεηξαηώο πξνθεηκέλνπ λα

 ΢ηνηρεία ηερληθνύ ππεύζπλνπ:

 ΢ηνηρεία επηρείξεζεο πνπ αλήθεη ην ζύζηεκα:

 3d-secure test account (γηα ηε δηαδηθαζία πηζηνπνίεζεο θαηόρνπ

 Paycenter test account (γηα ηελ απνζηνιή ζπλαιιαγήο κέζσ ηνπ

Πιεξνθνξίεο γηα ηε ρξεζηκόηεηα απηώλ ησλ ζηνηρείσλ πεξηιακβάλνληαη ζηηο

΢ε on-line ζπλαιιαγέο αγνξάο ή πξνέγθξηζεο (βι. ελόηεηα 5 γηα ηνπο ηύπνπο

Γηα δνθηκαζηηθέο ζπλαιιαγέο ζηελ πιαηθόξκα ηεο Cardinal:

Γηα πξαγκαηηθέο ζπλαιιαγέο ζηελ πιαηθόξκα ηεο Cardinal:

 Σν λόκηζκα πνπ ρξεζηκνπνηείηαη ζηε 3D-Secure δηαδηθαζία

 Ζ δηαδηθαζία πηζηνπνίεζεο πξνεγείηαη κόλν ζπλαιιαγώλ αγνξάο

 Γηα ζπλαιιαγέο πνπ γίλνληαη από ζπζηήκαηα όπνπ ν θάηνρνο δίλεη

 Ζ ηηκή ηεο παξακέηξνπ «OrderNumber» ζην «cmpi_lookup»

 Γελ πξέπεη πνηέ λα ζηέιλεηαη ηηκή ζηελ παξάκεηξν

΢ηα πιαίζηα ησλ δνθηκαζηηθώλ ζπλαιιαγώλ πνπ ζα πξαγκαηνπνηεζνύλ από ην

Verified by Δίλαη απόθαζε ηεο επηρείξεζεο αλ ζα ζηαιεί ή όρη Όρη

Verified by Δίλαη απόθαζε ηεο επηρείξεζεο αλ ζα ζηαιεί ή όρη Όρη

Verified by Θα πξέπεη λα ζηαιεί ζπλαιιαγή ζην Paycenter κε ηα Λαη

Verified by Δίλαη απόθαζε ηεο επηρείξεζεο αλ ζα ζηαιεί ή όρη Όρη

Verified by Δίλαη απόθαζε ηεο επηρείξεζεο αλ ζα ζηαιεί ή όρη Όρη

Mastercard Δίλαη απόθαζε ηεο επηρείξεζεο αλ ζα ζηαιεί ή όρη Όρη

Mastercard Θα πξέπεη λα ζηαιεί ζπλαιιαγή ζην Paycenter κε ηα Λαη

Mastercard Δίλαη απόθαζε ηεο επηρείξεζεο αλ ζα ζηαιεί ή όρη Όρη

Mastercard Δίλαη απόθαζε ηεο επηρείξεζεο αλ ζα ζηαιεί ή όρη Όρη

 Δάλ κία ζπλαιιαγή αγνξάο/

 Δθόζνλ κία ζπλαιιαγή αγνξάο ή

2) Λα δεηείηαη από ην ρξήζηε λα εηζάγεη

 Ζ παξάκεηξνο είλαη πξναηξεηηθή

Οη παξάκεηξνη πνπ ζηέιλνληαη ζηελ απάληεζε, είλαη νη εμήο:

 Σηκή δηάθνξε ηνπ 0: Τπήξμε

Δηδηθά γηα ηε ζπλαιιαγή κε RequestType=

 Σηκή δηάθνξε ηνπ 0: Σν

 Δάλ ην request απνξξίθζεθε

 Δάλ ρξεζηκνπνηνύληαη θάπνηεο από ηηο ζπλαιιαγέο νινθιήξσζεο

 Από ηηο ππόινηπεο παξακέηξνπο, ζπληζηάηαη επηπιένλ λα

 Tα κελύκαηα απόξξηςεο ζπλαιιαγήο ή ηερληθνύ ιάζνπο

΢ηνλ πίλαθα πνπ αθνινπζεί, εκθαλίδνληαη νη παξάκεηξνη ηνπ «Transaction Web

CardType (2) (2)

CardNumber (2) (2)

ExpirationMonth (2) (2)

ExpirationYear (2) (2)

Cvv2 (2) (2)

CardHolderName (2) (2)

Track2 (3) (3)

Cavv (4) (4)

Xid (4) (4)

TaxCardNumber (5) (5) (5) (5) (5) (5)