- Κατευθυντήριες οδηγίες ενοποίησης
- Τρόποι πληρωμής
- Secure Remote Commerce
Secure Remote Commerce
Το Secure Remote Commerce (SRC) είναι μια έξυπνη επιλογή online checkout χωρίς κωδικούς πρόσβασης για γρήγορη και εύχρηστη εμπειρία checkout για τους πληρωτές. Το SRC παρέχει ένα μόνο κουμπί checkout (αναφέρεται επίσης ως Click to Pay) και μια τυποποιημένη ροή checkout για όλα τα συμμετέχοντα προγράμματα καρτών, συμπεριλαμβανομένων των Mastercard, Visa, American Express, Discover και άλλων. Το SRC βασίζεται στην προδιαγραφή SRC της EMVCo και αντικαθιστά τα Masterpass, Visa Checkout και Amex Express Checkout.
Ένας πληρωτής μπορεί να δημιουργήσει ένα προφίλ SRC χρησιμοποιώντας τη διεύθυνση email του. Στο checkout, ο πληρωτής πρέπει στη συνέχεια να δώσει αυτή τη διεύθυνση email και να πραγματοποιήσει ένα επιπλέον βήμα επαλήθευσης με έναν κωδικό μίας χρήσης. Μπορεί επίσης να κάνει την επιλογή "Να με θυμάσαι" για να παραβλεφθεί η επαλήθευση όταν χρησιμοποιείται ο ίδιος browser.
Ο πληρωτής μπορεί να αποθηκεύσει πολλαπλές πιστωτικές, χρεωστικές ή προπληρωμένες κάρτες, τις σχετικές διευθύνσεις χρέωσης και πολλαπλές διευθύνσεις αποστολής στο προφίλ SRC. Οι λεπτομέρειες της κάρτας αποθηκεύονται με ασφάλεια και πρόσθετη ασφάλεια παρέχεται προσφέροντας tokenization δικτύου.
Το SRC επιτρέπει στον πληρωτή να επιλέξει τις λεπτομέρειες πληρωμής που θα χρησιμοποιηθούν για την πληρωμή. Ωστόσο, η ίδια η πληρωμή διεκπεραιώνεται χρησιμοποιώντας την τράπεζα εμπόρου που έχει διαμορφωθεί για το προφίλ εμπόρου στην πύλη.
Το SRC υποστηρίζεται στη σελίδα πληρωμής της πύλης (Hosted Checkout), ή μέσω ενός JavaScript SDK αν χρησιμοποιείτε τη δική σας σελίδα πληρωμής.
Βασικά οφέλη
Το SRC προσφέρει τα ακόλουθα πλεονεκτήματα:
- Γρήγορη, εύχρηστη επιλογή checkout για τους πληρωτές σας με μειωμένο κίνδυνο εγκατάλειψης του checkout
- Υψηλότερα ποσοστά έγκρισης αν χρησιμοποιείτε token δικτύου
- Μειωμένο ενδεχόμενο εξαπάτησης των πληρωτών
- Ασφαλής ανταλλαγή δεδομένων πληρωμής, συμπεριλαμβανομένων λεπτομερειών κάρτας, χρεώσεων και λεπτομερειών διεύθυνσης αποστολής
Προαπαιτούμενα
Αν θέλετε να προσφέρετε το SRC ως επιλογή checkout στους πληρωτές σας:
- Επικοινωνήστε με τον your payment service provider για να βεβαιωθείτε ότι το SRC είναι διαθέσιμο σε εσάς.
- Από το μενού Admin στο Merchant Administration, κάντε κλικ στην επιλογή Διαμόρφωση SRC και ακολουθήστε τις οδηγίες για ενοποίηση στο SRC και την ενεργοποίησή του για το προφίλ εμπόρου σας. Πρέπει να έχετε το απαιτούμενο δικαίωμα ενημέρωσης της διαμόρφωσης SRC.
Το SRC ως επιλογή checkout στο Hosted Checkout
Αν χρησιμοποιείτε τη σελίδα πληρωμής της πύλης (Hosted Checkout), το SRC θα προσφέρεται αυτόματα ως επιλογή checkout στους πληρωτές σας αν έχετε ενεργοποιήσει το SRC για το προφίλ εμπόρου και χρησιμοποιείτε το DirectAPI έκδοση 57 ή νεότερη κατά την υποβολή του αιτήματος Create Checkout Session για εκκίνηση της αλληλεπίδρασης Hosted Checkout.
Ενώ το προφίλ SRC του πληρωτή σας μπορεί να περιέχει κάρτες για υποστηριζόμενα προγράμματα καρτών, για μια δεδομένη συναλλαγή ο πληρωτής σας μπορεί να χρησιμοποιεί το SRC μόνο για κάρτες:
- για τις οποίες το πρόγραμμα κάρτας έχει ενεργοποιηθεί για SRC στο προφίλ εμπόρου σας, και
- το προφίλ εμπόρου σας έχει διαμορφωθεί για τη διεκπεραίωση καρτών με αυτό το πρόγραμμα και το νόμισμα συναλλαγής.
Διεύθυνση αποστολής: Διεύθυνση αποστολής: Οι πληρωτές δεν θα μπορούν να επιλέξουν μια διεύθυνση αποστολής κατά την αλληλεπίδραση SRC, καθώς η συλλογή διεύθυνσης αποστολής δεν υποστηρίζεται προς το παρόν μέσω του Hosted Checkout.
Διεύθυνση χρέωσης: Μια διεύθυνση χρέωσης θα συλλέγεται πάντα κατά την αλληλεπίδραση SRC.
Ταυτοποίηση 3-D Secure: Αν έχετε διαμορφωθεί για ταυτοποίηση 3-D Secure (3DS), το Hosted Checkout θα εκτελεί αυτόματα την ταυτοποίηση 3DS μετά την αλληλεπίδραση SRC.
Για να χρησιμοποιήσετε το Hosted Checkout, ακολουθήστε τα βήματα όπως ορίζονται στην Υλοποίηση μιας ενοποίησης Hosted Checkout.
Όταν γίνεται η κλήση του Checkout.configure(), συμπληρώστε τις ακόλουθες λεπτομέρειες:
| Χώρα αλληλεπίδρασης | Για μια αλληλεπίδραση SRC, η χώρα αλληλεπίδρασης καθορίζει το περιεχόμενο για τη χώρα που θα εμφανίζεται στον πληρωτή κατά την αλληλεπίδραση SRC, όπως τους Όρους και τις Προϋποθέσεις. Η τιμή που διαμορφώσατε για το προφίλ εμπόρου σας στην πύλη χρησιμοποιείται από προεπιλογή. Προσθέστε το πεδίο interaction.country στη μέθοδο Checkout.configure() αν θέλετε να παρακάμψετε αυτή την τιμή για αυτή την αλληλεπίδραση. |
| Τοπικές ρυθμίσεις αλληλεπίδρασης | Για μια αλληλεπίδραση SRC, οι τοπικές ρυθμίσεις αλληλεπίδρασης καθορίζουν τη γλώσσα εμφάνισης. Από προεπιλογή, χρησιμοποιείται η γλώσσα που έχει διαμορφωθεί στον browser του πληρωτή. Αν η γλώσσα του πληρωτή δεν μπορεί να προσδιοριστεί ή δεν υποστηρίζεται, χρησιμοποιείται η επιλογή en_US. Αν θέλετε να παρακάμψετε αυτή την τιμή, προσθέστε το πεδίο interaction.locale στη μέθοδο Checkout.configure(). Προς το παρόν, οι υποστηριζόμενες γλώσσες είναι Αγγλικά (ΗΒ) (en_UK), Ισπανικά (Ισπανίας) (es_ES), Γαλλικά (Καναδς) (fr_CA), Πορτογαλικά (Βραζιλίας) (pt_BR) και Κινεζικά (Χονγκ Κονγκ) (zh_HK). |
| Όνομα εμπόρου | Δώστε τον διακριτικό τίτλο σας, δηλαδή την επωνυμία που είναι γνωστή στον πληρωτή σας. Η επωνυμία μπορεί να εμφανίζεται κατά την αλληλεπίδραση SRC. |
| URL εμπόρου | Δώστε τη διεύθυνση URL του ιστότοπού σας που χρησιμοποιεί ο πληρωτής. Για παράδειγμα, https://example.com. Η διεύθυνση URL μπορεί να εμφανίζεται κατά την αλληλεπίδραση SRC. |
| Email πληρωτή | Η διεύθυνση email του πληρωτή θα συλλέγεται πάντα κατά την αλληλεπίδραση SRC. Αν γνωρίζετε ήδη τη διεύθυνση email του πληρωτή, προσθέστε customer.email:<τη διεύθυνση email του πληρωτή> στο Checkout.configure() για να επιτρέψετε στον πληρωτή να παρακάμψει την εισαγωγή της διεύθυνσης email του κατά την αλληλεπίδραση SRC. |
<html>
<head>
<script src="https://na-gateway.mastercard.com/static/srci/1.2.0/srci.min.js"
data-error="errorCallback"
data-cancel="cancelCallback"></script>
<script type="text/javascript">
function errorCallback(error) {
console.log(JSON.stringify(error));
}
function cancelCallback() {
console.log('Payment cancelled');
}
Checkout.configure({
merchant: "<gateway_merchant_ID>",
session: {
id: "<session_ID>",
},
customer: {
email: "<payer_email_address>"
},
order: {
amount: "60",
currency: "USD",
description: "High level description of the goods contained in the order",
id: "<your_unique_order_ID>",
},
interaction: {
country: "USA",
locale: "en_US",
operation: "AUTHORIZE",
merchant: {
name: "<merchant_name>",
url: "<website_URL>",
address: {
line1: "200 Sample St",
line2: "1234 Example Town"
}
}
}
});
</script>
</head>
<body>
...
<input
type="button"
value="Pay with Lightbox"
onclick="Checkout.showLightbox();"
/>
<input
type="button"
value="Pay with Payment Page"
onclick="Checkout.showPaymentPage();"
/>
...
</body>
</html>
Το SRC ως επιλογή checkout στη σελίδα πληρωμής
Αν χρησιμοποιείτε τη δική σας σελίδα πληρωμής και θέλετε να προσφέρετε SRC ως επιλογή checkout στους πληρωτές σας, χρησιμοποιήστε το SRCI JavaScript SDK (srci.js) που παρέχεται από την πύλη.
Πρόκειται για μια ενοποίηση JavaScript client που σας επιτρέπει να εκκινήσετε την αλληλεπίδραση SRC απευθείας από τον browser του πληρωτή και διασφαλίζει ότι οι λεπτομέρειες πληρωμής που επιλέγονται από τον πληρωτή κατά τη διάρκεια της αλληλεπίδρασης SRC υποβάλλονται απευθείας από τον browser του πληρωτή στην πύλη.
Για να χρησιμοποιήσετε το SRCI JavaScript SDK, ακολουθήστε τα βήματα παρακάτω.
Βήμα 1: Δημιουργία περιόδου λειτουργίας
Δημιουργήστε μια περίοδο λειτουργίας υποβάλλοντας ένα αίτημα Create Session από την εφαρμογή διακομιστή. Η απόκριση επιστρέφει ένα ID περιόδου λειτουργίας, το οποίο πρέπει να χρησιμοποιήσετε στα επακόλουθα βήματα για αναφορά σε αυτή την περίοδο λειτουργίας.
Βήμα 2: Ενημερώστε την περίοδο λειτουργίας με το ποσό παραγγελίας και το νόμισμα
Ενημερώστε την περίοδο λειτουργίας με το ποσό και το νόμισμα για την παραγγελία υποβάλλοντας ένα αίτημα Update Session από την εφαρμογή διακομιστή. Αυτό το βήμα απαιτείται για να μπορέσετε στη συνέχεια να ρωτήσετε για το SRC που είναι διαθέσιμο για πληρωμές με αυτό το νόμισμα.
| URL | https://na-gateway.mastercard.com/api/rest/version/72/merchant/<your_merchant_ID>/session/<your_session_ID> |
| Μέθοδος HTTP | PUT |
{
"order":{
"amount":100.00,
"currency":"USD"
}
}
Βήμα 3: Συμπεριλάβετε το SRCI JavaScript SDK στη σελίδα πληρωμής.
Συμπεριλάβετε το SRCI JavaScript SDK (srci.js) που παρέχεται από την πύλη στη σελίδα πληρωμής σας προσθέτοντας ένα στοιχείο script εντός του στοιχείου head. Αυτό τοποθετεί ένα αντικείμενο SRCi στον χώρο ονομάτων παραθύρων.
<script type="text/javascript" src="https://na-gateway.mastercard.com/static/srci/1.2.0/srci.min.js"></script>
Βήμα 4: Διαμορφώστε την αλληλεπίδραση SRC
Κατά τη φόρτωση της σελίδας πληρωμής σας, εκκινήστε την αλληλεπίδραση SRC κάνοντας κλικ στη μέθοδο SRCi.configure().
<html>
<head>
<script type="text/javascript" src="https://na-gateway.mastercard.com/static/srci/1.2.0/srci.min.js"></script>
<script type="text/javascript">
var callback = function (response) {
if(response.result === "SUCCESS") {
console.log("Response from SDK: %s", response.restApiResponse);
} else if(response.result === "ERROR") {
console.log("An error occurred");
}
}
SRCi.configure(
"<your_gateway_merchant_ID>",
"<your_merchant_name>",
"<your_merchant_URL>",
"<your_session_ID>",
{ wsVersion: 57 },
callback
);
</script>
</head>
<body>
...
</body>
</html>
Λεπτομέρειες εμπόρου
Απαιτείται το merchantId έτσι ώστε η πύλη να μπορεί να καθορίσει σωστά τις επιλογές πληρωμής σας.
Τα πεδία merchantName και merchantUrl υποβάλλονται στον διακομιστή SRC. Αυτές οι λεπτομέρειες μπορούν να παρουσιάζονται στον πληρωτή κατά τη διάρκεια της αλληλεπίδρασης SRC.
Δώστε τον διακριτικό τίτλο σας, δηλαδή την επωνυμία που είναι γνωστό στον πληρωτή σας και τη διεύθυνση URL του ιστότοπού σας που χρησιμοποιεί ο πληρωτής.
Έκδοση
Ορίστε αυτήν την τιμή σε 57. Είναι η έκδοση που χρησιμοποιήσατε κατά την υποβολή του αιτήματος Create Session.
Ανάκληση
Χρησιμοποιήστε την παράμετρο callback για να ορίσετε τις ενέργειες που θα κληθούν αφού ολοκληρωθεί το SRCi.configure(). Για παράδειγμα, ίσως να θέλετε να συνδεθείτε αν η μέθοδος ήταν επιτυχής:
var srciConfigCallback = function (resp) {
var response = resp.restApiResponse;
if (response.result === "ERROR") {
console.error("SRC could not successfully be configured");
} else if (response.result === "SUCCESS") {
console.log("SRC was successfully configured");
}
}
Η κλήση SRCi.configure() ενδέχεται να επιστρέψει τις ακόλουθες αποκρίσεις σφάλματος:
response.cause |
resp.explanation |
Απαιτούμενη ενέργεια |
|---|---|---|
| Σφάλμα | Λείπει όρισμα: Τα Merchant ID, Merchant Name, Merchant URL, Hosted Session ID και η συνάρτηση ανάκλησης είναι όλα απαιτούμενα ορίσματα για τη μέθοδο configure(). |
Διορθώστε την ενοποίησή σας. Πρέπει να δώσετε όλα τα υποχρεωτικά πεδία αιτήματος |
| Σφάλμα | Λείπει όρισμα: Το URL εμπόρου είναι ένα απαιτούμενο όρισμα για τη μέθοδο configure() |
Διορθώστε την ενοποίησή σας. Πρέπει να παρέχετε το πεδίο URL εμπόρου. |
| Σφάλμα | Η ανάκληση πρέπει αν είναι συνάρτηση. | Διορθώστε την ενοποίησή σας. |
| Σφάλμα | Η έκδοση API πρέπει να είναι έκδοσης <MIN_VERSION> ή νεότερη. |
Διορθώστε την ενοποίησή σας. Ορίστε το wsVersion σε 57. |
Σε περίπτωση επιστροφής σφάλματος, μην προχωρήσετε στο επόμενο βήμα. Προσφέρετε στον πληρωτή έναν άλλο τρόπο πληρωμής.
Σύνθετη διαμόρφωση
Το SDK ανακτά λεπτομέρειες σχετικά με τη διαμόρφωση προφίλ εμπόρου για SRC (συμπεριλαμβανομένης, για παράδειγμα, της λίστας όλων των προγραμμάτων για τα οποία είναι διαθέσιμο το SRC) χρησιμοποιώντας την πράξη Payment Options Inquiry. Ωστόσο, αν έχετε ήδη υποβάλει ένα αίτημα Payment Options Inquiry κατά το session του πληρωτή, μπορείτε να δώσετε αυτές τις λεπτομέρειες προσθέτοντας το στοιχείο configuration στο αίτημα.
Σε αυτήν την περίπτωση, το SDK δεν εκτελεί ξανά το αίτημα Payment Options Inquiry. Η παράμετρος wsVersion υποδεικνύει την έκδοση DirectAPI που χρησιμοποιήσατε για να υποβάλετε το αίτημα Payment Options Inquiry.
<html>
<head>
<script type="text/javascript" src="https://na-gateway.mastercard.com/static/srci/1.2.0/srci.min.js"></script>
// Response from the Payment Options Inquiry call. This value to SRCi.configure() is optional. If it is not passed in, a call will be made from the SDK to the API to retrieve it.
var paymentOptionsInquiryResponse = {
merchant: "<gateway_merchant_ID>",
paymentTypes: {
card: {
cardTypes: [{
cardType: "MASTERCARD",
schemeTokenTypes: "CRYPTOGRAM_3DSECURE"
}, {
cardType: "VISA",
schemeTokenTypes: "CRYPTOGRAM_3DSECURE"
}, {
cardType: "AMEX",
schemeTokenTypes: "DYNAMIC_CSC_AND_EXPIRY"
}],
walletProviders: [{
secureRemoteCommerce: {
defaultPayerCountry: "USA",
shippingAddressCountries : "USA,CAN"
scheme: [{
dpaId: "<DPA_ID>", // As configured for this scheme on your merchant profile.
name: "MASTERCARD"
}, {
dpaId: "<DPA_ID>", // As configured for this scheme on your merchant profile.
name: "VISA"
}, {
name: "AMERICAN_EXPRESS"
}]
},
walletProvider: "SECURE_REMOTE_COMMERCE"
}]
}
},
result: "SUCCESS"
}
SRCi.configure({
"<gateway_merchant_ID>",
"<merchant_name>",
"<merchant_URL>",
"<session_ID>",
configuration: {
wsVersion: 57,
paymentOptions: paymentOptionsInquiryResponse
},
callback: function (response) {
if(response.result === "SUCCESS") {
console.log("Response from SDK: %s", response.restApiResponse);
} else if(response.result === "ERROR") {
console.log("An error occurred");
}
}
});
</script>
</head>
<body>
...
</body>
</html>
Παράδειγμα απόκρισης SRCi.configure()
Το ακόλουθο παράδειγμα δείχνει μια επιτυχημένη κλήση SRCi.configure().
{
result: "SUCCESS"
restApiResponse: <Payments Options Inquiry response>
}
Η απόκριση περιέχει την απόκριση Payments Options Inquiry στο πεδίο restApiResponse, που δίνεται μόνο για ενημέρωση. Ωστόσο, ίσως θελήσετε να χρησιμοποιήσετε αυτές τις πληροφορίες αργότερα κατά την περίοδο λειτουργίας του πληρωτή αντί να χρησιμοποιήσετε το αίτημα PAYMENT_OPTIONS_INQUIRY για την ανάκτησή του.
Το ακόλουθο παράδειγμα δείχνει μια ανεπιτυχή κλήση SRCi.configure().
{
result: "ERROR"
cause: <cause>
explanation: <explanation>
}
Σε αυτήν την περίπτωση, ζητήστε από τον πληρωτή να κάνει μια άλλη επιλογή checkout.
Βήμα 5: Εμφανίστε το SRC ως επιλογή checkout
Αν το SRCi.configure() ήταν επιτυχές, εμφανίστε το SRC ως επιλογή checkout στη σελίδα πληρωμής. Για τις απαιτήσεις branding, βλ. Οδηγίες περιβάλλοντος εργασίας (UI) χρήστη SRC.
Χρησιμοποιήστε τις λεπτομέρειες διαμόρφωσης SRC που επιστρέφονται στην απόκριση Payment Options Inquiry για να προσδιορίσετε ποια λογότυπα προγραμμάτων θα εμφανίζονται μέσα στο κουμπί. Για κάθε υποστηριζόμενο πρόγραμμα, η απόκριση Payment Options Inquiry περιέχει το όνομα του προγράμματος στο πεδίο paymentTypes.card.walletProviders[n].secureRemoteCommerce.scheme[n].name.
Βήμα 6: Εκκινήστε το περιβάλλον εργασίας του SRC
Όταν ο πληρωτής επιλέξει το SRC ως επιλογή checkout, εκκινήστε το περιβάλλον εργασίας του SRC κάνοντας επίκληση στη μέθοδο SRCi.launchUI().
var payloadCallback = function (correlationId, scheme) {
console.log("Payload callback complete with correlation id %s and scheme %s", correlationId, scheme);
};
var errorCallback = function (error) {
console.log("Error callback triggered with error: %s", error);
};
var cancelCallback = function () {
console.log("Cancel callback triggered");
};
SRCi.launchUI({
orderAmount: "100.00",
orderCurrency: "USD"
},
payloadCallback,
errorCallback,
cancelCallback
);
Εκτός από τα υποχρεωτικά πεδία, μπορείτε επίσης να δώσετε έναν αριθμό προαιρετικών πεδίων:
SRCi.launchUI(
{
"orderAmount":"60"
"orderCurrency":"USD",
"customerEmail":"<payer_email_address>",
"collectShippingAddress":true,
"interactionCountry":"CAN"
"interactionLocale":"fr"
}
);
Συλλογή διεύθυνσης email πληρωτή
Η διεύθυνση email του πληρωτή θα συλλέγεται πάντα κατά την αλληλεπίδραση SRC. Αν γνωρίζετε ήδη τη διεύθυνση email του πληρωτή, προσθέστε το πεδίο customerEmail στη μέθοδο SRCi.launchUI() για να επιτρέψετε στον πληρωτή να παρακάμψει την εισαγωγή της διεύθυνσης email του κατά την αλληλεπίδραση SRC.
Συλλογή διεύθυνσης χρέωσης
Μια διεύθυνση χρέωσης θα συλλέγεται πάντα κατά την αλληλεπίδραση SRC.
Συλλογή διεύθυνσης αποστολής
Από προεπιλογή, το SRC δεν συλλέγει τη διεύθυνση αποστολής του πληρωτή. Αν θέλετε το SRC να συλλέγει τη διεύθυνση αποστολής του πληρωτή, προσθέστε το collectShippingAddress:true στη μέθοδο SRCi.launchUI().
Από προεπιλογή, ο πληρωτής μπορεί να επιλέξει οποιαδήποτε χώρα για τη διεύθυνση αποστολής. Για να περιορίσετε τη λίστα των χωρών όπου αποστέλλετε αγαθά, πρέπει να διαμορφώσετε το προφίλ εμπόρου σας για το SRC μέσω του Merchant Administration είτε με μια λίστα επιτρεπόμενων χωρών είτε με μια λίστα εξαιρούμενων χωρών. Όπου έχετε ορίσει περιορισμούς, ο πληρωτής θα μπορεί να επιλέξει μόνο μια επιτρεπόμενη χώρα για τη διεύθυνση αποστολής.
Δεν μπορείτε να παρακάμψετε τις υποστηριζόμενες χώρες στη διεύθυνση αποστολής για ένα συγκεκριμένο αίτημα.
Χώρα αλληλεπίδρασης
Η χώρα αλληλεπίδρασης καθορίζει το περιεχόμενο για τη χώρα που θα εμφανίζεται στον πληρωτή κατά την αλληλεπίδραση SRC, όπως τους Όρους και τις Προϋποθέσεις. Η τιμή που διαμορφώσατε για το προφίλ εμπόρου σας στην πύλη χρησιμοποιείται από προεπιλογή. Προσθέστε το πεδίο interactionCountry στη μέθοδο SRCi.launchUI() αν θέλετε να παρακάμψετε αυτή την τιμή για αυτή την αλληλεπίδραση.
Τοπικές ρυθμίσεις αλληλεπίδρασης
Οι τοπικές ρυθμίσεις αλληλεπίδρασης καθορίζουν τη γλώσσα που χρησιμοποιείται κατά την αλληλεπίδραση SRC. Από προεπιλογή, χρησιμοποιείται η γλώσσα που έχει διαμορφωθεί στον browser του πληρωτή. Αν η γλώσσα του πληρωτή δεν μπορεί να προσδιοριστεί ή δεν υποστηρίζεται, χρησιμοποιείται η επιλογή en_US. Προσθέστε το πεδίο interactionLocale στη μέθοδο SRCi.launchUI() αν θέλετε να παρακάμψετε αυτή την τιμή. Προς το παρόν, οι υποστηριζόμενες γλώσσες είναι Αγγλικά (ΗΒ) (en_UK), Ισπανικά (Ισπανίας) (es_ES), Γαλλικά (Καναδς) (fr_CA), Πορτογαλικά (Βραζιλίας) (pt_BR) και Κινεζικά (Χονγκ Κονγκ) (zh_HK).
Ανάκληση
Πρέπει να ορίσετε τις ενέργειες που θα κληθούν αφού ολοκληρωθεί το SRCi.launchUI() ως εξής:
payloadCallback |
Συνάρτηση ανάκλησης που ενεργοποιείται όταν ο πληρωτής έχει ολοκληρώσει την αλληλεπίδραση στο περιβάλλον εργασίας του SRC. Αυτή η συνάρτηση χρησιμοποιεί δύο ορίσματα, το correlationId και το scheme
Αυτές οι λεπτομέρειες πρέπει στη συνέχεια να χρησιμοποιηθούν για την ανάκτηση των λεπτομερειών πληρωμής για αυτήν την αλληλεπίδραση SRC (βλ. Βήμα 7). |
|||||||||||||||||||||
errorCallback |
Η συνάρτηση ανάκλησης που ενεργοποιείται αν προκύψει σφάλμα κατά τη φόρτωση του περιβάλλοντος εργασίας SRC. Αυτή η συνάρτηση χρησιμοποιεί ένα όρισμα που θα συμπληρωθεί με ένα αντικείμενο σφάλματος που περιέχει τις λεπτομέρειες σφάλματος.
|
|||||||||||||||||||||
cancelCallback |
Η συνάρτηση ανάκλησης που ενεργοποιείται όταν ο πληρωτής ακυρώσει την αλληλεπίδραση SRC ή το περιβάλλον εργασίας του SRC είναι κλειστό. Δεν χρησιμοποιεί ορίσματα. |
Βήμα 7: Ενημερώστε την περίοδο λειτουργίας με τις λεπτομέρειες πληρωμής SRC
Αφού ο πληρωτής ολοκληρώσει με επιτυχία την αλληλεπίδραση SRC, πρέπει να ζητήσετε από την πύλη την ανάκτηση των λεπτομερειών πληρωμής για την αλληλεπίδραση SRC και να τις αποθηκεύσετε στην περίοδο λειτουργίας.
Υποβάλετε ένα αίτημα Update Session From Wallet με:
- το ID περιόδου λειτουργίας στη διεύθυνση URL του αιτήματος, και
- το
correlationIdκαι το πρόγραμμα όπως επιστρέφεται στοpayloadCallback
| URL | https://na-gateway.mastercard.com/api/rest/version/72/merchant/<your_merchant_ID>/session/<your_session_ID> |
| Μέθοδος HTTP | POST |
{
"apiOperation":"UPDATE_SESSION_FROM_WALLET",
"order":{
"walletProvider":"SECURE_REMOTE_COMMERCE"
},
"wallet":{
"secureRemoteCommerce":{
"srcCorrelationId":"<correlationId_provided_in_payloadCallback>",
"scheme":"<scheme_provided_in_payloadCallback>"
}
}
}
Αν η περίοδος λειτουργίας (session) έχει ενημερωθεί με επιτυχία με τις λεπτομέρειες πληρωμής από την αλληλεπίδραση SRC, μπορείτε να συνεχίσετε. Αν η περίοδος λειτουργίας (session) δεν έχει ενημερωθεί με επιτυχία, ζητήστε από τον πληρωτή να κάνει μια άλλη επιλογή checkout.
Βήμα 8: Εκτελέστε ταυτοποίηση 3-D Secure (προαιρετικά)
Αν θέλετε να ταυτοποιήσετε τον πληρωτή, εκτελέστε ταυτοποίηση 3-D Secure χρησιμοποιώντας την περίοδο λειτουργίας (session). Για λεπτομέρειες, βλ. Υλοποίηση μιας ενοποίησης 3DS χρησιμοποιώντας το 3DS JavaScript API.
Βήμα 9: Εκτελέστε πράξη πληρωμής
Αν η περίοδος λειτουργίας (session) ενημερώθηκε με επιτυχία με τις λεπτομέρειες πληρωμής από την αλληλεπίδραση SRC (και την ταυτοποίηση 3-D Secure, εφόσον εκτελείται στο βήμα 8), χρησιμοποιήστε την για να υποβάλετε την πληρωμή προς διεκπεραίωση από την εφαρμογή διακομιστή. Για παράδειγμα, μπορείτε να υποβάλετε ένα αίτημα Authorize. Οι λεπτομέρειες πληρωμής που έχουν αποθηκευθεί στην περίοδο λειτουργίας (session) από την αλληλεπίδραση SRC χρησιμοποιούνται για τη διεκπεραίωση της πληρωμής. Μπορείτε να χρησιμοποιήσετε την περίοδο λειτουργίας (session) για έναν αριθμό λειτουργιών API, βλ. Χρήση περιόδου λειτουργίας για περισσότερες πληροφορίες.
| URL | https://na-gateway.mastercard.com/api/rest/version/72/merchant/<your_merchant_ID>/order/<your_order_ID>/transaction/<your_transaction_ID> |
| Μέθοδος HTTP | PUT |
{
"session":{
"id":"<session_ID>"
} "..."
}
Το παρακάτω παράδειγμα κώδικα HTML δείχνει πώς να ενοποιήσετε το SRCi.js στη σελίδα πληρωμής σας. Σημειώστε στα εξής:
- Το
SRCi.configure()πρέπει να κληθεί αμέσως αφού η δέσμη ενεργειώνsrci.min.jsφορτωθεί στη σελίδα. Αν επιχειρηθεί η κλήση τουSRCi.configure()μέσα στη λαβή χειρισμού κλικ στο κουμπί, το αποτέλεσμα θα είναι ορισμένοι browser να αποκλείσουν το άνοιγμα του παραθύρου πληρωμής SRC. - Ο δείκτης χειρισμού συμβάντος κουμπιού Pay πρέπει πρώτα να ελέγξει ότι το JavaScript SDK έχει διαμορφωθεί πλήρως. Η απόπειρα κλήσης του
SRCi.launchUI()πριν από μια επιτυχημένη διαμόρφωση θα προκαλέσει λάθη και θα επηρεάσει αρνητικά την εμπειρία του πληρωτή. - Το κουμπί Pay θα πρέπει να απενεργοποιείται πριν από την κλήση του SRCi.launchUI() και να ενεργοποιείται ξανά σε κάθε μία από τις ανακλήσεις. Η απόπειρα κλήσης του
SRCi.launchUI()πολλαπλές φορές μπορεί να έχει ως αποτέλεσμα μη αναμενόμενη συμπεριφορά.
<html>
<head>
<script type="text/javascript" src="https://na-gateway.mastercard.com/static/srci/1.2.0/srci.min.js"></script>
<script type="text/javascript">
var configured = false;
//SRCi global object is initialized by srci script
SRCi.configure(
"<gateway_merchant_ID>",
"<merchant_name>",
"<merchant_URL>",
"<session_ID>",
{ wsVersion: 57 },
function (response) {
if(response.result === "SUCCESS") {
configured = true;
console.log("Response from SDK: %s", response.restApiResponse);
} else if(response.result === "ERROR") {
console.log("An error occurred");
}
}
);
var payloadCallback = function (correlationId, scheme) {
console.log("Payload callback complete with correlation id %s and scheme %s", correlationId, scheme);
enablePayButton();
};
var errorCallback = function (error) {
console.log("Error callback triggered with error %s", error);
enablePayButton();
};
var cancelCallback = function () {
console.log("Cancel callback triggered");
enablePayButton();
};
function enablePayButton() {
document.getElementById("payButton").disabled = false;
}
function disablePayButton() {
document.getElementById("payButton").disabled = true;
}
function pay() {
if (configured) {
// ensure only one payment window is launched
disablePayButton();
SRCi.launchUI({
orderAmount: "100.00",
orderCurrency: "USD"
},
payloadCallback,
errorCallback,
cancelCallback
);
} else {
console.error("SRCi is not configured");
}
}
</script>
</head>
<body>
<button id="payButton" type="button" onclick="pay();">Pay</button>
</body>
</html>
πληροφορίες πληρωμής SRC
Αυτή η ενότητα περιγράφει τις λεπτομέρειες πληρωμής που επιστρέφονται για αλληλεπιδράσεις SRC.
Τύπος λεπτομερειών πληρωμής που επιστράφηκαν για αλληλεπιδράσεις SRC
Το SRC υποστηρίζει την επιστροφή διαφορετικών τύπων λεπτομερειών πληρωμής για διεκπεραίωση. Οι λεπτομέρειες πληρωμής που επιστρέφονται από το σύστημα SRC εξαρτώνται από τον τύπο που ζητά η πύλη, τη διαμόρφωσή σας στο σύστημα SRC και το πρόγραμμα της κάρτας. Το SRC επιστρέφει συνήθως ένα token δικτύου, τη λήξη του token και ένα πλήρες κρυπτογράφημα (όπου υποστηρίζεται από το πρόγραμμα της κάρτας).
Ωστόσο, όταν η πύλη δεν είναι σε θέση να στείλει ένα token δικτύου με πλήρες κρυπτογράφημα στην τράπεζα εμπόρου σας, το SRC πρέπει αντ' αυτού να παρέχει ένα token δικτύου, τη λήξη του token και δυναμικό κωδικό ασφαλείας κάρτας (CSC). Η πύλη θα διασφαλίσει αυτόματα ότι ζητείται ο σωστός τύπος λεπτομέρειας πληρωμής.
Αν μια κάρτα δεν υποστηρίζει το tokenization δικτύου (για παράδειγμα, όταν ο εκδότης δεν συμμετέχει), το SRC επιστρέφει τις λεπτομέρειες της κάρτας (τον αριθμό κάρτας και τη λήξη κάρτας) αντί για τις λεπτομέρειες token δικτύου (token δικτύου, λήξη token και κρυπτογράφημα ή δυναμικό CSC).
Αν είστε έμπορος με έδρα στις ΗΠΑ και έχετε δηλώσει ότι θέλετε να κάνετε χρήση των δικαιωμάτων σας βάσει της τροποποίησης Durbin, η SRC παρέχει τις λεπτομέρειες της κάρτας (αριθμός κάρτας και λήξη κάρτας) για χρεωστικές κάρτες.
Λεπτομέρειες πληρωμής SRC στο API Transaction Response
Οι λεπτομέρειες πληρωμής που επιλέγονται από τον πληρωτή κατά την αλληλεπίδραση SRC αποθηκεύονται στην περίοδο λειτουργίας (session) και επιστρέφονται στην απόκριση συναλλαγής για αιτήματα API που εκτελούνται χρησιμοποιώντας την περίοδο λειτουργίας (session). Όταν το SRC παρέχει τις λεπτομέρειες του token δικτύου, παρέχονται τόσο οι λεπτομέρειες του token δικτύου όσο και οι λεπτομέρειες της (αποκρυμμένης) κάρτας.
Ανάλογα με τον τύπο των λεπτομερειών πληρωμής που επιστρέφονται από το σύστημα SRC, λαμβάνετε τις παρακάτω λεπτομέρειες στην απόκριση API.
| Token δικτύου με πλήρες κτυπρόγραμμα (η American Express δεν υποστηρίζει αυτόν τον τύπο token δικτύου) (Το κρυπτογράφημα δεν επιστρέφεται στις αποκρίσεις συναλλαγών) |
|
| Token δικτύου με δυναμικό CSC (Το CSC δεν επιστρέφεται στις αποκρίσεις συναλλαγών) |
|
| Αριθμός κάρτας και λήξη |
|
Λεπτομέρειες πληρωτή
Το όνομα και ο αριθμός τηλεφώνου του πληρωτή παρέχονται στην απόκριση συναλλαγής στην ομάδα παραμέτρων customer.
Η διεύθυνση email του πληρωτή παρέχεται στην απόκριση συναλλαγής στο πεδίο customer.email αν έχετε ορίσει το consumerEmailAddressRequested σε true.
Λεπτομέρειες διεύθυνσης χρέωσης
Οι λεπτομέρειες διεύθυνσης χρέωσης που συσχετίζονται με την κάρτα παρέχονται στην απόκριση συναλλαγής στην ομάδα παραμέτρων billing.address.
Στοιχεία διεύθυνσης αποστολής
Αν έχετε ορίσει το collectShippingAddress σε true, οι λεπτομέρειες διεύθυνσης αποστολής παρέχονται στην απόκριση συναλλαγής στην ομάδα παραμέτρων shipping.address.
Συναλλαγές που εκκινούνται από τον έμπορο
Δεν πρέπει να προσφέρετε SRC ως επιλογή checkout στους πληρωτές σας αν θέλετε να χρησιμοποιήσετε στη συνέχεια αυτές τις λεπτομέρειες πληρωμής για να εκκινήσετε πληρωμές σε μια σειρά, όπως επαναλαμβανόμενες πληρωμές ή πληρωμές σε δόσεις. Αυτό θα υποστηριχθεί σε μελλοντική έκδοση.
Δοκιμή της ενοποίησής σας
Όταν ολοκληρώσετε την ενοποίησή σας με την πύλη για SRC, μπορείτε να τη δοκιμάσετε χρησιμοποιώντας το δοκιμαστικό προφίλ εμπόρου (μπροστά στο ID εμπόρου προστίθεται το πρόθημα TEST). Όταν χρησιμοποιείτε το δοκιμαστικό προφίλ εμπόρου, η πύλη παρέχει έναν προσομοιωτή για την αλληλεπίδραση SRC. Ο προσομοιωτής SRC χρησιμοποιεί ένα σύνολο προκαθορισμένων λεπτομερειών πληρωμής που δεν μπορούν να τροποποιηθούν. Με βάση τις προκαθορισμένες λεπτομέρειες πληρωμής, μπορείτε να ενεργοποιήσετε και να δοκιμάσετε διαφορετικά σενάρια, όπως περιγράφεται παρακάτω.
Η δεύτερη στήλη στους παρακάτω πίνακες δείχνει τα 4 τελευταία ψηφία του FPAN που επέλεξε ο πληρωτής κατά την αλληλεπίδραση SRC. Για να ενεργοποιήσετε ένα σενάριο, επιλέξτε το αντίστοιχο FPAN στον προσομοιωτή κατά την αλληλεπίδραση SRC του πληρωτή.
| Πρόγραμμα | Τελευταία 4 ψηφία του FPAN | ID συσχέτισης SRC | Προκύπτουσα απόκριση API UPDATE_SESSION_FROM_WALLET | Προκύπτουσα απόκριση API AUTHORIZE ή PAY |
|---|---|---|---|---|
| Mastercard | xxx0007 | 783a935d-c6a9-4289-b19d-c3336f998b57 |
|
|
| Visa | xxx0003 | 12345671-visaTAVV-expiry0822-colShiptrue |
|
|
| Πρόγραμμα | Τελευταία 4 ψηφία του FPAN | ID συσχέτισης SRC | Προκύπτουσα απόκριση API UPDATE_SESSION_FROM_WALLET | Προκύπτουσα απόκριση API AUTHORIZE ή PAY |
|---|---|---|---|---|
| Mastercard | xxx0008 | 261af700-e576-43bf-af92-bd0f6810e8fb |
|
|
| Visa | xxx0002 | 12345671-visaDTVV-expiry0822-colShiptrue |
|
|
| American Express | xxx0017 | cf3de1e0-55a2-44cf-9563-5ef9e648c492 |
|
|
| Πρόγραμμα | Τελευταία 4 ψηφία του FPAN | ID συσχέτισης SRC | Προκύπτουσα απόκριση API UPDATE_SESSION_FROM_WALLET | Προκύπτουσα απόκριση API AUTHORIZE ή PAY |
|---|---|---|---|---|
| Mastercard | xxx0305 | 8e455e8b-4e52-46cf-a3da-83aa3cf9a76e |
|
|
| Visa | xxx0001 | 12345671-visa1-expiry0822 |
|
|
| American Express | xxx4564 | bb978084-42b7-4985-af9d-2e41ee0a370c |
|
|
Δοκιμασία του SRC με ταυτοποίηση 3-D Secure
Αν το προφίλ εμπόρου σας είναι ενεργοποιημένο για ταυτοποίηση EMV 3-D Secure (3DS2) μπορείτε να χρησιμοποιήσετε τις λεπτομέρειες δοκιμής SRC που εμφανίζονται στον παρακάτω πίνακα για να ενεργοποιήσετε μια frictionless ροή ή μια ροή challenge.
| Πρόγραμμα | Τελευταία 4 ψηφία του FPAN | ID συσχέτισης SRC | Προκύπτουσα απόκριση API |
|---|---|---|---|
| Mastercard | xxx0009 | 1049624e-cc67-45f6-bd5f-c625eb4c6cc1 |
|
| Visa | xxx4222 | 12345671-SRC3DSChallenge-expiry0822-colShiptrue |
|
| American Express | xxx0017 | 16e051bc-bd25-46db-a7d3-d2944fbb05cf |
|
| Πρόγραμμα | Τελευταία 4 ψηφία του FPAN | ID συσχέτισης SRC | Προκύπτουσα απόκριση API |
|---|---|---|---|
| Mastercard | xxx0010 | 16e051bc-bd25-46db-a7d3-d2944fbb05cf |
|
| Visa | xxx4180 | 12345671-SRC3DSFrictionless-expiry0822-colShiptrue |
|
| American Express | xxx4564 | 17e051bc-bd25-46db-a7d3-d2944fbb05cf |
|