Εργαλεία Χρήστη

Εργαλεία ιστότοπου


vivapay

Εισαγωγή

H Viva ξεκίνησε πρόσφατα τη λειτουργεία μας πρωτοποριακής μεθόδου πληρωμών, για τα ελληνικά δεδομένα τουλάχιστον. Χωρίς πολλές διατυπώσεις και γραφειοκρατεία, με μοναδική προϋπόθεση να είστε επαγγελματίας, μπορείτε μέσα σε λίγα λεπτά να δημιουργήσετε ένα λογαριασμό και να αρχίσετε την παραγωγική χρήση της υπηρεσίας. Η φιλοσοφία λειτουργίας μοιάζει αρκετά με το PayPal, αφού οι εισπράξεις παραμένουν στο σύστημα της Viva μέχρι να μεταφερθούν στο δικό σας τραπεζικό λογαριασμό την επόμενη εργάσιμη ημέρα. Επιπλέον παρέχει πολύ μεγάλη ποικιλία τρόπων χρέωσης των πελατών σας, είτε μέσα από το site σας, είτε τηλεφωνικώς με αυτοματοποιημένο σύστημα, είτε χειροκίνητα, είτε μέσω εφαρμογών από το κινητό σας τηλέφωνο (υπό ανάπτυξη), είτε και χωρίς κάρτα μέσω μεταφοράς από τραπεζικό λογαριασμό με συγκεκριμένο κωδικό πληρωμής. Ξεχάστε τις πολυσέλιδες συμβάσεις και τις πολυήμερες αναμονές για έγκριση άτοκων δόσεων. Με την εγγραφή σας έχετε αμέσως δικαίωμα χρέωσης με δόσεις, δυνατότητα μέσα από το site σας επιστροφής ολικού ή μερικού ποσού, και πολλές άλλες ευκολίες τις οποίες μπορείτε να μελετήσετε κι εσείς στο site της Viva αναλυτικότερα.

  • Το module δημιουργεί το table mod_vivapay, στο οποίο αποθηκεύονται προσωρινά κάποια δεδομένα σχετικά με την κάθε κίνηση. Δεν χρησιμοποιούνται ούτε ενδιάμεσα αρχεία, ούτε cookies, εκτός από το cookie για την επιθυμία του πελάτη να χρησιμοποιήσει δόσεις.
  • Δεν χρειάζεται να ορίσετε εσείς τα ποσοστά των προμηθειών. Το σύστημα της Viva τα στέλνει αυτόματα με κάθε ολοκληρωμένη συναλλαγή.
  • Μπορείτε μέσα από το admin panel του WHMCS να κάνετε ολική ή μερική επιστροφή κάποιας συναλλαγής. Έχετε υπόψη πως μερική επιστροφή μπορεί να γίνει μόνο σε εκκαθαρισμένες συναλλαγές, αλλιώς γίνεται ολική ακύρωση.
  • Το module συνδυάζει τη default γλώσσα του site σας με τις προτιμήσεις του πελάτη, και αποφασίζει αυτόματα αν θα εμφανίσει τη φόρμα της Viva στα ελληνικά ή στα αγγλικά.
  • Οι σελίδες στις οποίες επιστρέφει ο πελάτης, πέρα από τις τυποποιημένες του WHMCS και τη δυνατότητα να εμφανίσετε κάποια δική σας html σελίδα, μπορούν να είναι και php scripts.

Το module έχει δοκιμαστεί με την έκδοση 5.3.10 του WHMCS, αλλά δεν θα πρέπει να έχετε πρόβλημα και με προηγούμενες εκδόσεις, τουλάχιστον μέχρι και την 4.4.

Είναι προφανές πως δεν έχω καμία επαγγελματική σχέση με τη Viva ή την VivaPayments, των οποίων τα σήματα και οι τίτλοι είναι αποκλειστικά δικές τους ιδιοκτησίες αντίστοιχα. Για οποιαδήποτε δυσλειτουργία του module επικοινωνήστε μαζί μας, αλλά για προβλήματα σχετικά με την Τράπεζα θα πρέπει να επικοινωνήσετε με την ίδια την Τράπεζα. Μπορείτε να επικοινωνήσετε μαζί μας στο www.valuehost.com.gr ή στο e-mail support@valuehost.com.gr.

Εγκατάσταση

  1. Αν ανεβάσετε τα αρχεία με FTP, θα πρέπει να τα ανεβάσετε υποχρεωτικά σε BINARY mode και όχι σε ASCII
  2. Βάζετε το vivapay.php στον κατάλογο /modules/gateways
  3. Φτιάχνετε τον κατάλογο /modules/gateways/vivapay
  4. Βάζετε τα functions.php, formredir.php, processor.php στον κατάλογο /modules/gateways/vivapay
  5. Σε περίπτωση που θέλετε να έχετε custom σελίδες επιστροφής, στον παραπάνω κατάλογο βάλτε τα αντίστοιχα αρχεία.
  6. Από το admin panel του WHMCS, πηγαίνετε στο Setup/Payments/Payment Gateways
  7. Επιλέξτε από τη λίστα το VivaPay και πατήστε Activate
  8. Προχωρήστε στην Παραμετροποίηση.

Παραμετροποίηση

Viva back-end

Από το admin panel της Viva, πηγαίνετε στην επιλογή Sales/Payment Sources/New website/App.

Αν η περιοχή πελατών τρέχει κάτω από secure server, θα πρέπει να βάλετε στα URLs το https. Αφού ολοκληρώσετε τη διαδικασία αυτή, θα δείτε και το SourceID που πρέπει να βάλετε στις ρυθμίσεις του module.

WHMCS back-end

  • Show on order form - Τσεκάρετε την επιλογή αυτή αν θέλετε το module να προσφέρετε στους πελάτες σας ως τρόπος πληρωμής.
  • Display Name - Το λεκτικό που θα εμφανίζεται στην επιλογή του τρόπου πληρωμής, πχ Πληρωμή με κάρτα, ή VivaPay. Το default είναι το VivaPay μαζί με την έκδοση του module. Η τιμή του πεδίου αυτού δεν έχει σχέση με τον τίτλο που εμφανίζεται στο back-end.
  • License number - Ο αριθμός αδείας που έχετε πάρει από την ValueHost. ΠΡΟΣΟΧΗ: Θα πρέπει να συμπεριλάβετε ΚΑΙ το λεκτικό 'VIVtrial-' ή 'VIVowned-' για τη δοκιμαστική ή αγορασμένη έκδοση αντίστοιχα.
  • Merchant ID - Το MerchantID που σας έχει δώσει η Viva (στο μενού ‘Settings/API Access’).
  • SourceID - Το Code που σας έχει δώσει η Viva (στο μενού ‘Sales/Payment Sources’).
  • Password - To API Key στη Viva (στο μενού ‘Settings/API Access’).
  • Disable libcurl - Κλήση της Viva χωρίς τη χρησιμοποίηση της libcurl.
  • Maximum installments - Το μέγιστο των δόσεων που έχετε δικαιώμα να κάνετε ή θέλετε να προσφέρετε.
  • Minimum value per installment - Το ελάχιστο ποσό δόσης που θα χρεώνεται. Αν δηλαδή το μέγιστο δόσεων είναι 5 και το ελάχιστο ποσό 30 ευρώ, τότε η χρέωση των 100 ευρώ θα γίνει σε 100/30=3,33 ή με στρογγυλοποίηση προς τα κάτω 3 δόσεις των 33,33 ευρώ. Αντίστοιχα μια χρέωση των 50 ευρώ, δεν θα γίνει σε δόσεις αφού 50/30=1,67 ή με στρογγυλοποίηση προς τα κάτω 1 δόση.
  • Success page - Κενό αν θέλετε την default σελίδα, αλλιώς το όνομα του αρχείου που περιέχει τον html ή PHP script που θέλετε να εμφανίζεται/εκτελείται στις επιτυχείς συναλλαγές. (Μηνύματα στον χρήστη)
  • Fail page - Κενό αν θέλετε την default σελίδα, αλλιώς το όνομα του αρχείου που περιέχει τον html ή PHP script που θέλετε να εμφανίζεται/εκτελείται στις ανεπιτυχείς συναλλαγές. (Μηνύματα στον χρήστη)
  • Test mode - Επιλέξτε το αν θέλετε να κάνετε δοκιμαστικές συναλλαγές. Υπόψη πως θα πρέπει να ορίσετε ανάλογα τα MerchantID/SourceID/Password τα οποία έχετε από το demo περιβάλλον.
  • Debug mode - Ενεργοποιήστε αυτή την επιλογή για να δείτε τι ακριβώς συμβαίνει στη διάρκεια λειτουργίας του module.
  • Convert To For Processing - Αυτή η επιλογή θα σας εμφανιστεί μόνο αν χρησιμοποιείτε πολλαπλά νομίσματα στο WHMCS (πχ Ευρώ και Δολλάριο). Αν ισχύει κάτι τέτοιο, η επιλογή αυτή πρέπει να είναι υποχρεωτικά το Ευρώ, αφού η Viva κάνει συναλλαγές μόνο σε Ευρώ. (Πολλαπλά νομίσματα)

Λειτουργία δόσεων

Πέρα από την παραμετροποίηση που αναφέραμε παραπάνω, θα πρέπει να κάνετε κάποιες αλλαγές και στα templates που χρησιμοποιείτε, ώστε να δώσετε το δικαίωμα στους χρήστες να επιλέξουν αν θέλουν να γίνει η χρέωση με δόσεις ή όχι. Για λόγους αναφοράς, θα περιγράψουμε τις αλλαγές που θα πρέπει να γίνουν στα templates default και web20cart της έκδοσης 5.2.7 του WHMCS, δείγματα από τα οποία μπορείτε να βρείτε και στο zip που κατεβάσατε. Αναλόγως ποια templates χρησιμοποιήτε, κάνετε τις αντίστοιχες αλλαγές. Πρακτικά, αυτό που θα πρέπει να μπει σε όλες τις σελίδες που επιλέγει ο πελάτης μέθοδο πληρωμής, είναι ένα έξτρα πεδίο στη φόρμα της μορφής checkbox με όνομα use_installments και να δημιουργηθεί με javascript ένα αντίστοιχο cookie. Το module στη συνέχεια ελέγχει αυτό το cookie, και σε συνδυασμό με τις παραμέτρους εγκατάστασης, αποφασίζει αν θα κάνει τη χρέωση με δόσεις καθώς και το πλήθος τους.

Αρχικά θα πρέπει να κάνετε μια προσθήκη στο αρχείο γλώσσας, της μεταβλητής:

$_LANG[‘installments’] = ‘Δόσεις’;

Αυτό είναι το λεκτικό που θα εμφανίζεται δίπλα στο checkbox. Σε όλα templates θα πρέπει να μπει το παρακάτω javascript με τη μορφή ακριβώς που βλέπεται το οποίο θα αναφέρουμε στη συνέχεια ως script για λόγους συντομίας:

{literal}
<script language="javascript">
function createInstCookie(name,value,days) {
  if (days) {
    var date = new Date();
    date.setTime(date.getTime()+(days*24*60*60*1000));
    var expires = "; expires="+date.toGMTString();
  } else
    var expires = "";
  document.cookie = name+"="+value+expires+"; path=/";
}
createInstCookie('use_installments','',-1);
</script>
{/literal}

Στη συνέχεια ανοίγετε τα templates (πχ templates/default και templates/orderforms/web20cart):

  • templates/default/viewinvoice.tpl - Ψάχνετε για τη γραμμή που γράφει <html>{if $status eq “Unpaid”}</html>. Ακριβώς από κάτω βάζετε βάζετε το script. Λίγο παρακάτω και μετά από το <html><form method=“post” action=“{$smarty.server.PHP_SELF}?id={$invoiceid}”>{$gatewaydropdown}</html> και πριν από το <html></form></html> βάζετε το:
    <div class="clearfix">
      <label for="installments">{$LANG.installments}:&nbsp;</label>
      <div class="input">
        <input type="checkbox" name="use_installments" id="installments" onclick="createInstCookie('use_installments',this.checked,1);"/>
      </div>
    </div>
  • templates/default/clientarreaaddfunds.tpl - Αν δεν έχετε ενεργοποιήσει την επιλογή να προσθέτουν χρήματα οι πελάτες σας ή δεν θέλετε να προσθέτουν χρήματα με δόσεις, μην τροποποιήσετε αυτό το template. Διαφορετικά, ψάχνετε για τη 2η γραμμή που γράφει <html><div class=”controls”></html>. Ακριβώς από κάτω βάζετε βάζετε το script. Λίγο παρακάτω και μετά από τα <html>{/foreach}</select></html> και πριν από το <html></div></html> βάζετε το:
    <div class="clearfix">
      <label for="installments">{$LANG.installments}:&nbsp;</label>
      <div class="input">
        <input type="checkbox" name="use_installments" id="installments" onclick="createInstCookie('use_installments',this.checked,1);"/>
      </div>
    </div>
  • templates/default/masspay.tpl - Ψάχνετε για τη γραμμή που γράφει <html>{foreach from=$gateways key=num item=gateway}</html>. Λίγο παρακάτω και μετά το <html>{/foreach}</html> και πριν το <html><br /></html> βάζετε το script και ακριβώς από κάτω βάζετε το:
    <div class="clearfix">
      <label for="installments">{$LANG.installments}:&nbsp;</label>
      <div class="input">
        <input type="checkbox" name="use_installments" id="installments" onclick="createInstCookie('use_installments',this.checked,1);"/>
      </div>
    </div>
  • templates/orderforms/web20cart/viewcart.tpl - Ψάχνετε για τη γραμμή που γράφει <html>{foreach key=num item=gateway from=$gateways}</html>. Λίγο παρακάτω και μετά το <html>{/foreach}</html> και πριν το <html></div></html> βάζετε το script και ακριβώς από κάτω βάζετε το:
    <div class="clearfix">
      <label for="installments">{$LANG.installments}:&nbsp;</label>
      <div class="input">
        <input type="checkbox" name="use_installments" id="installments" onclick="createInstCookie('use_installments',this.checked,1);"/>
      </div>
    </div>

Αναλόγως ποιο template χρησιμοποιείτε, τροποποιήστε το αντίστοιχο template ώστε να υπάρχει το javascript που δημιουργεί το cookie με το αντίστοιχο checkbox με την ονομασία use_installments. Τα παραπάνω παραδείγματα είναι ενδεικτικά.

Μηνύματα στον χρήστη

Η default λειτουργία του module, είναι πως μετά από κάθε συναλλαγή θα καλεί τη system σελίδα του WHMCS (από το root folder) viewinvoice.php με παραμέτρους id=[Αριθμός Τιμολογίου] και paymentsuccess=true για τις επιτυχείς συναλλαγές και paymentfailed=true για τις ανεπιτυχείς/ακυρωμένες συναλλαγές (πχ: http://www.mysite.gr/whcms/viewinvoice.php?id=123&paymentsuccess=true). Η σελίδα αυτή εμφανίζει στην ουσία το τιμολόγιο το οποίο έχει ζητηθεί, και με πράσινα γράμματα αναφέρει πως η συναλλαγή είναι επιτυχημένη και με κόκκινα πως έχει αποτύχει ή ακυρώθηκε. Το πως ακριβώς εμφανίζονται αυτά τα δεδομένα, μπορείτε να τα τροποποιήσετε πειράζοντας τα αντίστοιχα templates του WHCMS αλλά αυτή η εργασία δεν καλύπτεται από το κείμενο που διαβάζετε τώρα.

Αν δεν σας καλύπτει αυτός ο τρόπος, υπάρχουν δύο εναλλακτικές, με όποιο συνδυασμό θέλετε. Μπορείτε να καλείτε είτε μια html σελίδα, είτε ένα php script. Το module θα εμφανίσει στο χρήστη το αποτέλεσμα της σελίδας αυτής, αφού κάνει τις απαραίτητες εγγραφές στα logs και τα tables του WHMCS, οπότε το μόνο που θα πρέπει να σας απασχολήσει είναι το αισθητικό κομμάτι σε αυτές τις σελίδες. Αν αφήσετε τα αντίστοιχα πεδία κενά στις ρυθμίσεις του module (success/fail/cancel page), θα εμφανιστούν οι default σελίδες που αναφέραμε παραπάνω. Αν έχετε ορίσει κάποιες σελίδες και για κάποιο λόγο δεν μπορεί το module να τις διαβάσει (πχ λάθος όνομα αρχείου), θα εμφανιστούν οι default σελίδες. Αν το αρχείο που θα βάλετε στις ρυθμίσεις έχει την κατάληξη php, το module θα το χειριστεί σαν php, αλλιώς σαν ένα απλό text αρχείο. ΠΡΟΣΟΧΗ: Τα αρχεία αυτά θα πρέπει να βρίσκονται στον κατάλογο modules/gateways/vivapay.

Λεκτικά

Λεκτικό Περιγραφή Ενδεικτική απάντηση
TimeStamp Η ώρα που έγινε η συναλλαγή 2013-07-03T17:31:28.3863894+03:00
TransactionId Ο μοναδικός αριθμός της συναλλαγής που έγινε f07faa3d-bfd0-4789-bfac-4778980c2b00
OrderCode Ο μοναδικός αριθμός της παραγγελίας που έγινε 123456789012
Status Το λεκτικό που επιστρέφει η Viva για τη συναλλαγή The transaction has been completed successfully
AmountEuro Το ποσό της συναλλαγής σε ευρώ 100
Amount Το ποσό της συναλλαγής στο βασικό νόμισμα 140
ClientIP Η IP του πελάτη που έκανε τη χρέωση 111.222.111.222
Invoice Ο αριθμός του τιμολογίου σας 123
Description Η περιγραφή του τιμολογίου σας ValueHost – Τιμολόγιο #123
Email Το e-mail του πελάτη client@mail.gr
Phone Το τηλέφωνο του πελάτη 2101234567
FullName Το πλήρες όνομα του πελάτη σε greeklish ATHANASIOS LIAGKOS
Installments Δόσεις που έκανε ο πελάτης (>=1) 3
CardNumber Ένα μέρος από τον αριθμό της κάρτας 411111XXXXXX1111
CountryCode Χώρα έκδοσης της κάρτας US
IssuingBank Τράπεζα έκδοσης της κάρτας JPMORGAN CHASE BANK N.A.
CardHolderName Όνομα δικαιούχου της κάρτας ATHANASIOS LIAGKOS
CardType Είδος κάρτας Visa
ErrorCode Κωδικός λάθους (0=Επιτυχής συναλλαγή) 403
ErrorText Περιγραφή λάθους (κενό στην επιτυχή συναλλαγή) The specified api action is disabled for the merchant

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

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

HTML

Το module ψάχνει οπουδήποτε για κάποια λεκτικά, τα οποία θα πρέπει να έχουν στην αρχή και στο τέλος δύο φορές το σύμβολο %, όπως μπορείτε να δείτε και στα ενδεικτικά αρχεία ok.html, nok.html, cancel.html τα οποία περιλαμβάνονται στο zip. Αν για παράδειγμα στο αρχείο αυτό βρεθεί το <html>PayMethod</html> τότε και μόνο τότε θα αντικατασταθεί με την αντίστοιχη τιμή.

Η σελίδα που καλείται απλώς εμφανίζεται και δεν είναι ούτε σε frame ή iframe ή κάτι τέτοιο. Οπως αναφέραμε λοιπόν παραπάνω, θα πρέπει να φροντίσετε εσείς στη σελίδα αυτή να δώσετε τη δυνατότητα στον χρήστη να επιστρέψει στην κεντρική σελίδα του site σας ή κάπου αλλού. Μια γρήγορη λύση, είναι να προσθέσετε μια γραμμή επάνω σαν την <html><META HTTP-EQUIV=“refresh” CONTENT=“3; URL=http://www.mysite.gr/clientarea.php”></html> ή ακόμα και <html><META HTTP-EQUIV=“refresh” CONTENT=“3; URL=http://www.mysite.gr/viewinvoice.php?id=%%InvoiceNumber%%&paymentseuccess=true”></html>. Το νούμερο '3' δίπλα στο CONTENT, σημαίνει μετά από πόσα δευτερόλεπτα ο browser θα πάει στη σελίδα που θέλετε.

PHP

Σε περίπτωση που οι γνώσεις σας το επιτρέπουν, μπορείτε να φτιάξετε ένα δικό σας PHP script που θα κάνει όποια λειτουργεία θέλετε με τα δεδομένα της συναλλαγής. Το module χρησιμοποιεί τη function cURL και καλεί με POST το script που έχετε δηλώσει. Στο script αυτό θα μεταφέρονται τα λεκτικά ως <php>$_POST</php> μεταβλητές. Αν για παράδειγμα στο αρχείο αυτό βρεθεί το <php>$_POST['PayMethod']</php> τότε και μόνο τότε θα έχετε την αντίστοιχη τιμή.

Οτιδήποτε επιστρέψει στην cURL αυτό το script, αυτό είναι και που θα εμφανιστεί στον χρήστη. Οπως αναφέραμε λοιπόν παραπάνω, θα πρέπει να φροντίσετε εσείς στη σελίδα αυτή να δώσετε τη δυνατότητα στον χρήστη να επιστρέψει στην κεντρική σελίδα του site σας ή κάπου αλλού. Μια γρήγορη λύση, είναι να προσθέσετε μια γραμμή επάνω σαν την <html><META HTTP-EQUIV=“refresh” CONTENT=“3; URL=http://www.mysite.gr/clientarea.php”></html> ή ακόμα και <php><META HTTP-EQUIV=“refresh” CONTENT=“3; URL=http://www.mysite.gr/viewinvoice.php?id=<?php echo $_POST[‘InvoiceNumber’]; ?>&paymentseuccess=true”></php>. Το νούμερο '3' δίπλα στο CONTENT, σημαίνει μετά από πόσα δευτερόλεπτα ο browser θα πάει στη σελίδα που θέλετε.

Επιστροφές (refunds)

Για να ακυρώσετε κάποια συναλλαγή ολικώς ή μερικώς, πηγαίνετε στα τιμολόγια (Billing/Invoices/Paid), επιλέξτε το τιμολόγιο που θέλετε και πατήστε το tab refund. Συμπληρώστε το ποσό που θέλετε, αν θα κάνετε μερική επιστροφή, και πατήστε Refund. To module θα τα κάνει όλα αυτόματα, αντιστρέφοντας τη συναλλαγή μαζί με την προμήθεια, με βασική προϋπόθεση να υπάρχει υπόλοιπο στο λογαριασμό σας στη Viva.

Σε δοκιμές που έχουν γίνει βέβαια, φαίνεται πως δεν επιτρέπεται να γίνεται μερική επιστροφή, μόνο ολόκληρη. Αυτός είναι περιορισμός της Viva. Επίσης για να μπορείτε να κάνετε επιστροφές, θα πρέπει από τις ρυθμίσεις ασφαλείας της Sales/API Access να ενεργοποιήσετε την επιλογή Allow refunds.

Πολλαπλά νομίσματα

Σε περίπτωση που για κάποιο λόγο στο site σας χρησιμοποιείτε άλλο νόμισμα εκτός του ευρώ, και με την προϋπόθεση πως έχετε στήσει σωστά τις ισοτιμές και τις τιμές των προϊόντων σας, το module θα μετατρέψει την τιμή σε ευρώ σύμφωνα με τη δική σας ισοτιμία, και θα χρεώσει το αντίστοιχο ποσό σε ευρώ, αν βέβαια στην παραμετροποίηση έχετε ρυθμίσει σωστά την επιλογή Convert To For Processing. Αν η συναλλαγή είναι επιτυχής, το module θα μετατρέψει πάλι το ποσό στο βασικό σας νόμισμα, όπως και την προμήθεια, και θα κάνει τις αντίστοιχες εγγαφές στο WHMCS σύμφωνα με αυτό και όχι με το ευρώ.

Έλεγχος λειτουργίας

Αν και έχει γίνει εξονυχιστικός έλεγχος, προτείνουμε να κάνετε έλεγχο σωστής λειτουργίας του module στο δοκιμαστικό περιβάλλον της Viva πριν αρχίσετε να το προσφέρετε ως τρόπο πληρωμής στους πελάτες σας.

Από το admin panel και συγκεκριμένα από την επιλογή Billing/Gateway Log μπορείτε να δείτε αναλυτικότατες πληροφορίες για τις συναλλαγές (επιτυχείς ή μη), οι οποίες σε περίπτωση προβλήματος θα σας βοηθήσουν να λύσετε το πρόβλημα αυτό σε συνεργασία με τους τεχνικούς της Viva.

Debug mode

Αν έχετε ενεργοποιήσει την επιλογή Debug mode στην παραμετροποίηση, μέσα στον κατάλογο /modules/gateways/vivapay θα δημιουργηθεί ένα πάρα πολύ αναλυτικό αρχείο με το όνομα debug.txt, για να δείτε ολόκληρη τη διαδικασία. Το αρχείο αυτό θα το χρειαστούμε κι εμείς, σε περίπτωση που έχετε πρόβλημα με κάποια συναλλαγή.

Ασυμβατότητα libcurl

Προέκυψε κάποια πρόβλημα τελευταία με αποτέλεσμα ορισμένοι να μην μπορούν να συνδεθούν με τη Viva καθόλου. Μετά από έλεγχο, διαπιστώθηκε πως υπάρχει ένα bug στη libcurl, το οποίες σε άλλα linux distributions έχει λυθεί και σε άλλα όχι, με αποτέλεσμα να μην είναι δυνατή καθόλου η επικοινωνία του module με τη χρήση της βιβλιοθήκης αυτής, συγκεκριμένα με το site της Viva. Εναλλακτικά, μπορεί πλέον το module να επικοινωνεί με τη χρήση της εντολής fopen, αλλά θα πρέπει να έχετε επιτρέψει στο php.ini να μπορεί η fopen να καλέσει URLs (allow_url_fopen = yes). Πολλοί ίσως για λόγους ασφαλείας να έχουν απενεργοποιήσει τη λειτουργία αυτή, είναι υποχρεωτικό όμως να την ενεργοποιήσουν αν πρέπει να χρησιμοποιούν αυτόν τον τρόπο σύνδεσης.

Ιστορικό εκδόσεων

  • 1.00 - 08/07/2013
    • Αρχική
  • 1.10 - 10/04/2014
    • Διόρθωση ενός σφάλματος όπου όταν το κυρίως νόμισμα του WHMCS δεν ήταν το ευρώ, το module εξοφλούσε το τιμολόγιο με την ισοτιμία του σε ευρώ, με αποτέλεσμα αναλόγως το νόμισμα η εξόφληση φαινόταν μεγαλύτερη ή μικρότερη της αξίας του τιμολογίου, όπως και το ποσό της προμήθειας.
    • Αντίστοιχα προστέθηκε το λεκτικό AmountEuro στις custom σελίδες επιστροφής, όπου υπάρχει η αξία του τιμολογίου στο σε ευρώ, ενώ στο Amount είναι πάντα στο βασικό νόμισμα του WHMCS.
  • 1.11 - 07/07/2014
    • Διόρθωση ενός σφάλματος κατά τη διαδικασία των επιστροφών.
    • Προσθήκη εναλλακτικού τρόπου σύνδεσης χωρίς τη χρήση της libcurl.
  • 1.12 - 05/08/2014
    • Προσθήκη του αναλυτικού debug log.
    • Τροποποίηση οδηγιών ώστε να συμβαδίζουν με το τρέχον περιβάλλον λειτουργίας της Viva (back-end).
  • 1.13 - 15/07/2015
    • Συμβατότητα με WHMCS 6.0
vivapay.txt · Τελευταία τροποποίηση: 15/07/2015 18:09 από Nasos Liagos

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki