- Κατευθυντήριες οδηγίες ενοποίησης
- Υποστηριζόμενες δυνατότητες (Επιλογές πληρωμής)
- Σύνδεσμοι πληρωμής
Σύνδεσμοι πληρωμής
Ο σύνδεσμος πληρωμής είναι μια ασφαλής μέθοδος παραλαβής πληρωμών μέσω ενός απλού URL συνδέσμου πληρωμών. Σας επιτρέπει να παρέχετε μια πρόσθετη λειτουργία αποδοχής μιας πληρωμής που περιλαμβάνει τη δημιουργία ενός URL συνδέσμου πληρωμής και, στη συνέχεια, να το μοιραστείτε με τον πληρωτή μέσω διάφορων καναλιών επικοινωνίας, όπως το email και ο κωδικός QR. Όταν ένας πληρωτής κάνει κλικ στο URL του συνδέσμου πληρωμής, ανακατευθύνεται στη σελίδα πληρωμής, όπου μπορεί να επιλέξει τον τρόπο πληρωμής για να ολοκληρωθεί η συναλλαγή.
Βασικά οφέλη
Τα βασικά οφέλη του συνδέσμου πληρωμής είναι ότι
- απλοποιεί τη διαδικασία πληρωμής
- βελτιώνει την εμπειρία χρήστη
- επιτρέπει γρηγορότερη πληρωμή, και
- σάς επιτρέπει να επικοινωνήσετε με έναν πελάτη μετά την αποτυχία μιας συναλλαγής ή την εγκατάλειψη ενός καλαθιού αγορών.
Χρησιμοποιήστε έναν σύνδεσμο πληρωμής
Όταν οι πληρωτές λαμβάνουν ένα μοναδικό URL συνδέσμου πληρωμής για την πληρωμή, μπορούν να κάνουν κλικ στον σύνδεσμο και να ολοκληρώσουν την πληρωμή.
Αυτό το διάγραμμα δείχνει τα διαφορετικά βήματα για να ολοκληρωθεί μια συναλλαγή με τη χρήση συνδέσμου πληρωμής.
- Εισαγάγετε τις πληροφορίες της πληρωμής, όπως τον αριθμό τιμολογίου, το συνολικό ποσό και το αίτημα δημιουργίας URL συνδέσμου πληρωμής.
- Η πύλη δημιουργεί έναν μοναδικό σύνδεσμο τον οποίο μπορείτε να μοιραστείτε με τους πληρωτές.
- Όταν οι πληρωτές κάνουν κλικ στον σύνδεσμο, ανακατευθύνονται σε μια σελίδα Hosted Checkout.
- Οι πληρωτές εισάγουν τις πληροφορίες πληρωμών στη σελίδα Hosted Checkout και ολοκληρώνουν την συναλλαγή.
Αίτημα για πράξη Initiate Checkout
Προαπαιτούμενα
Πριν την έναρξη αιτήματος checkout, βεβαιωθείτε ότι έχουν οριστεί τα ακόλουθα χαρακτηριστικά για Συνδέσμους πληρωμής:
- apiOperation: Ορίστε τιμή πεδίο για INITIATE_CHECKOUT.
- checkoutMode: Ορίστε τιμή πεδίου για INITIATE_CHECKOUT.
- interaction.operation: Επιλέξτε τύπο συναλλαγής AUTHORIZE ή PURCHASE.
- interaction.merchant.name: Το όνομα της επιχείρησής σας εμφανίζεται στον πληρωτή στη σελίδα checkout.
- interaction.merchant.url: Η διεύθυνση URL του ιστότοπου της επιχείρησής σας.
- order.amount: Το συνολικό ποσό για την παραγγελία. Πρόκειται για το καθαρό ποσό συν οποιοδήποτε πρόσθετο τέλος.
- order.currency: Το νόμισμα της παραγγελίας.
- order.description: Σύντομη κειμενική περιγραφή του περιεχομένου της παραγγελίας.
- paymentLink.errorUrl: Η διεύθυνση URL στην οποία θέλετε να ανακατευθυνθεί το browser του πληρωτή σε περίπτωση σφάλματος κατά την κλήση του συνδέσμου πληρωμής, όπως στην περίπτωση παραγγελίας που έχει ήδη πληρωθεί, συνδέσμου πληρωμής που έχει λήξει, μη έγκυρου συνδέσμου πληρωμής κ.λπ.
Αν καθοριστεί και παρουσιαστεί σφάλμα, η πύλη θα παρέχει τον κωδικό σφάλματος (
errorCode) και περιγραφή (errorDescription) ως παραμέτρους συμβολοσειράς ερωτήματος. Η πύλη θα διατηρήσει επίσης τυχόν παραμέτρους συμβολοσειράς ερωτήματος που μπορεί να έχετε συμπεριλάβει στο errorUrl.Για παράδειγμα, αν καθορίσετε το payLink.errorUrl ως https://merchant.com/myPaymentLinkErrorPage.html, σε περίπτωση σφάλματος, αυτό το errorUrl θα λάβει τις ακόλουθες παραμέτρους συμβολοσειράς ερωτήματος από την πύλη: https://merchant.com/myPaymentLinkErrorPage.html?errorCode=ERROR_CODE&errorDescription=Error+message. Δείτε την ενότητα Κωδικοί σφαλμάτων και περιγραφές για περισσότερες πληροφορίες.
Αυτό το πεδίο είναι προαιρετικό. Όταν αυτό το πεδίο δεν καθορίζεται, ο πληρωτής, σε περίπτωση σφάλματος, θα ανακατευθυνθεί στην οθόνη προεπιλεγμένου σφάλματος. - order.id: Ένα μοναδικό αναγνωριστικό για αυτή την παραγγελία, ώστε να διακρίνεται από άλλη παραγγελία που δημιουργείτε.
- paymentLink.expiryDateTime: Ημερομηνία και ώρα λήξης αυτού του Συνδέσμου πληρωμής. Η προεπιλογή είναι 3 μήνες.
- paymentLink.numberOfAllowedAttempts: Ο αριθμός των επιτρεπόμενων προσπαθειών μετά τις οποίες ο πληρωτής δεν θα μπορεί πλέον να πληρώσει χρησιμοποιώντας τον Σύνδεσμο πληρωμής. Η προεπιλογή είναι 25 προσπάθειες.
Δείγμα αιτήματος
Για να δημιουργήσετε ένα URL συνδέσμου πληρωμής, πρέπει να ζητήσετε μια πράξη Initiate Checkout με τη λειτουργία payment link. Αυτό είναι ένα δείγμα αποσπάσματος για την πράξη Initiate Checkout.
{
"apiOperation": "INITIATE_CHECKOUT",
"checkoutMode": "PAYMENT_LINK",
"interaction": {
"operation": "AUTHORIZE",
"merchant": {
"name": "<your_merchant_name>",
"url": "<website_url>"
}
},
"order": {
"currency": "USD",
"amount": 1234,
"id": "<order_ID>",
"description": "Ordered goods"
},
"paymentLink": {
"expiryDateTime": "2021-12-10T02:16:00.993Z",
"numberOfAllowedAttempts": "3"
}
}
Initiate Checkout - Αναφορά API [REST][NVP]
Μια επιτυχής απόκριση σε αυτή την πράξη περιέχει τις παραμέτρους του συνδέσμου πληρωμής URL και του συνδέσμου πληρωμής ID, οι οποίες μπορούν να κοινοποιηθούν στον πελάτη για την πραγματοποίηση της πληρωμής.
Δείγμα απόκρισης
{
"checkoutMode": "PAYMENT_LINK",
"merchant": "<your_merchant_id>",
"paymentLink": {
"expiryDateTime": "2021-12-10T02:16:00.993Z",
"id": "PAYLINK0001060519617G19059484L2",
"numberOfAllowedAttempts": 3,
"url": https://test.ibanke-commerce.nbg.gr/pbl/PAYLINK0001060519617G19059484L2
},
"result": "SUCCESS",
"successIndicator": "c89f62baad174e12"
}
Κοινή χρήση συνδέσμων πληρωμής
Ο έμπορος μοιράζεται τον σύνδεσμο πληρωμής με τον πληρωτή μέσω διαφόρων καναλιών επικοινωνίας, όπως email, μήνυμα κειμένου και κωδικούς QR. Ο πληρωτής κάνει κλικ στον σύνδεσμο πληρωμής ο οποίος τον ανακατευθύνει στη σελίδα πληρωμής Hosted Checkout σε έναν browser και ολοκληρώνει τη συναλλαγή χρησιμοποιώντας έναν από τους διαθέσιμους τρόπους πληρωμής.
Διαγραφή συνδέσμων πληρωμής
Η πράξη διαγραφής συνδέσμου πληρωμής σάς επιτρέπει να διαγράψετε ή να ακυρώσετε ρητώς τον σύνδεσμο πληρωμής αν ο πληρωτής έχει ήδη πραγματοποιήσει την πληρωμή εκτός σύνδεσης ή αν η πληρωμή δεν είναι πλέον αναγκαία.
| URL | https://test.ibanke-commerce.nbg.gr/api/rest/version/64/merchant/{merchantId}/link/{linkId} |
| Μέθοδος HTTP | DELETE |
Delete Payment Link – Αναφορά API [REST][NVP]
Η πύλη λήγει αυτόματα την περίοδο λειτουργίας αν:
- η πληρωμή δεν πραγματοποιηθεί εντός 3 μηνών από τη δημιουργία του συνδέσμου πληρωμής, ο πληρωτής δε θα μπορεί πλέον να χρησιμοποιήσει τον σύνδεσμο πληρωμής για να πραγματοποιήσει την πληρωμή
- ο αριθμός των προσπαθειών πληρωμής υπερβαίνει τις 25, ο πληρωτής δεν θα έχει πια πρόσβαση στον σύνδεσμο πληρωμής για να ολοκληρώσει τη συναλλαγή
- η πληρωμή που χρησιμοποιεί σύνδεσμο πληρωμής έχει ολοκληρωθεί, ή
- o έμπορος εκκινεί το αίτημα διαγραφής.
Δοκιμάστε έναν σύνδεσμο πληρωμής
Αφού δημιουργήσετε τον λογαριασμό σας και δομήσετε την ενοποίησή σας, θα πρέπει να δοκιμάσετε τον σύνδεσμο πληρωμής χρησιμοποιώντας το δοκιμαστικό προφίλ εμπόρου σας (το ID εμπόρου σας ξεκινάει με το πρόθημα "TEST"). Η πύλη παρέχει μια δοκιμαστική σελίδα hosted checkout για την επαλήθευση του συνδέσμου πληρωμής.
- Εισαγάγετε τις λεπτομέρειες πληρωμής και υποβάλετε αίτημα για τον σύνδεσμο πληρωμής μέσω της πράξης INITIATE_CHECKOUT. Όταν η πράξη INITIATE CHECKOUT είναι επιτυχής, επιστρέφεται ένα URL συνδέσμου πληρωμής.
- Πραγματοποιήστε την πληρωμή χρησιμοποιώντας την κάρτα δοκιμής που παρατίθεται στην ενότητα Λεπτομέρειες δοκιμής συναλλαγής με κάρτα.
Ειδοποιήσεις Webhook
Συνιστάται να επιλέξετε την υπηρεσία ειδοποιήσεων για να λαμβάνετε ειδοποιήσεις webhook αν η πληρωμή είναι επιτυχής. Για πρόσθετες πληροφορίες σχετικά με τις ειδοποιήσεις και τη διαμόρφωση webhook, βλ. την ενότητα Ειδοποιήσεις webhook.
Κωδικοί σφαλμάτων και περιγραφές
Αυτός ο πίνακας περιγράφει τη λίστα των κωδικών σφαλμάτων με περιγραφές.
| Κωδικός σφάλματος | Περιγραφή |
|---|---|
| EXPIRED | Ο σύνδεσμος πληρωμής έχει λήξει. Επικοινωνήστε με τον αιτούντα την πληρωμή. |
| PAID | Η παραγγελία που συσχετίζεται με αυτόν τον σύνδεσμο πληρωμής έχει πληρωθεί. Επικοινωνήστε με τον αιτούντα την πληρωμή. |
| USAGE_COUNT_EXCEEDED | Έχει υπερβεί ο μέγιστος αριθμός επιτρεπόμενων προσπαθειών. Επικοινωνήστε με τον αιτούντα την πληρωμή. |
| DOES_NOT_EXIST | Αυτός ο σύνδεσμος πληρωμής δεν είναι έγκυρος. Επικοινωνήστε με τον αιτούντα την πληρωμή. |
| UNEXPECTED_ERROR | Παρουσιάστηκε μη αναμενόμενο σφάλμα. Επικοινωνήστε με τον αιτούντα την πληρωμή. |
| DELETED | Αυτός ο σύνδεσμος πληρωμής διαγράφηκε. Επικοινωνήστε με τον αιτούντα την πληρωμή. |