- Linee guida per l'integrazione
- Modalità di pagamento
- Secure Remote Commerce
Secure Remote Commerce
Secure Remote Commerce (SRC) è un'opzione di checkout online intelligente e senza password che offre un'esperienza di checkout facile e veloce per i paganti. SRC fornisce un unico pulsante di checkout (noto anche come "Click to Pay") e un flusso di checkout standardizzato per tutti i circuiti di carte partecipanti, inclusi Mastercard, Visa, American Express, Discover e altri. SRC si basa sulle specifiche SRC di EMVCo e sostituisce Masterpass, Visa Checkout e Amex Express Checkout.
Un pagante può creare un profilo SRC utilizzando il proprio indirizzo email. Durante il checkout, il pagante deve quindi fornire questo indirizzo email ed eseguire un passaggio di verifica aggiuntivo con un codice monouso. Può anche scegliere l'opzione "Ricordami" per saltare successivamente la verifica quando utilizza lo stesso browser.
Il pagante può memorizzare più carte di credito, di debito o prepagate, gli indirizzi di fatturazione associati e più indirizzi di spedizione nel proprio profilo SRC. I dettagli della carta sono archiviati in modo sicuro e viene fornito un ulteriore livello di sicurezza offrendo la tokenizzazione di rete.
SRC consente al pagante di selezionare i dettagli di pagamento da utilizzare per il pagamento; tuttavia, il pagamento stesso viene elaborato utilizzando l'acquirer configurato per il profilo dell'esercente nel gateway.
SRC è supportato sulla pagina di pagamento del gateway (Hosted Checkout) o tramite un SDK JavaScript se si utilizza la propria pagina di pagamento.
Vantaggi principali
SRC offre i seguenti vantaggi:
- Opzione di checkout veloce e facile da usare per i propri paganti con un rischio ridotto di abbandono del checkout
- Tassi di approvazione di autorizzazione più elevati se si utilizzano token di rete
- Diminuzione delle frodi da parte dei paganti
- Scambio sicuro dei dati di pagamento inclusi i dettagli della carta, i dettagli dell'indirizzo di fatturazione e di spedizione
Prerequisiti
Se si desidera offrire SRC come opzione di checkout ai propri paganti:
- Contattare il your payment service provider per assicurarsi che SRC sia disponibile.
- Dal menu Amministrazione in Merchant Administration, fare clic su Configurazione SRC e seguire le istruzioni per eseguire l'integrazione a SRC e attivare SRC per il proprio profilo dell'esercente. È necessario disporre dei privilegi richiesti per aggiornare la configurazione SRC.
SRC come opzione di checkout in Hosted Checkout
Se si sta utilizzando la pagina di pagamento del gateway (Hosted Checkout), SRC verrà automaticamente offerto come opzione di checkout ai paganti se è stato attivato SRC per il proprio profilo dell'esercente e si sta utilizzando DirectAPI versione 57 o successive quando si invia la richiesta Create Checkout Session per avviare l'interazione di Hosted Checkout.
Sebbene lo stesso profilo SRC del pagante possa contenere carte per qualsiasi circuito della carta di credito supportato, per una data transazione il pagante può utilizzare SRC solo per quelle carte per cui:
- il circuito della carta di credito è stato attivato per SRC sul proprio profilo dell'esercente e
- Il proprio profilo dell'esercente è configurato per elaborare le carte con questo circuito della carta di credito e la valuta della transazione.
Indirizzo di spedizione: i paganti non saranno in grado di selezionare un indirizzo di spedizione durante l'interazione SRC, poiché la raccolta dell'indirizzo di spedizione non è attualmente supportata tramite Hosted Checkout.
Indirizzo di fatturazione: durante l'interazione SRC verrà sempre raccolto un indirizzo di fatturazione.
Autenticazione 3-D Secure: se è stato configurato il servizio 3-D Secure (3DS), Hosted Checkout eseguirà automaticamente l'autenticazione 3DS dopo l'interazione SRC.
Per utilizzare Hosted Checkout, seguire i passaggi indicati in Implementazione di un'integrazione Hosted Checkout.
Quando si chiama Checkout.configure()
, includere i seguenti dettagli:
Paese di interazione | Per un'interazione SRC, il paese dell'interazione determina il contenuto specifico del paese presentato al pagante durante l'interazione SRC, come ad esempio Termini e condizioni. Per impostazione predefinita viene utilizzato il valore configurato dall'esercente associato al proprio profilo dell'esercente nel gateway. Aggiungere il campo interaction.country al metodo Checkout.configure() , se si desidera ignorare questo valore per questa interazione. |
Lingua di interazione | Per un'interazione SRC, la lingua dell'interazione determina la lingua di visualizzazione. Per impostazione predefinita, viene utilizzata la lingua configurata nel browser del pagante. Se la lingua del pagante non può essere determinata o non è supportata, viene utilizzata la lingua en_US. Se si desidera sovrascrivere questo valore, aggiungere il campo interaction.locale al metodo Checkout.configure() . Attualmente, le lingue supportate sono inglese (Regno Unito) (en_UK), spagnolo (Spagna) (es_ES), francese (Canada) (fr_CA), portoghese (Brasile) (pt_BR) e cinese (Hong Kong) (zh_HK). |
Nome esercente | Fornire il proprio nome commerciale, ovvero il nome noto al pagante. Il nome può essere visualizzato durante l'interazione SRC. |
URL esercente | Fornire l'URL del proprio sito web che il pagante sta utilizzando. Ad esempio, https://example.com. L'URL può essere visualizzato durante l'interazione SRC. |
Email del pagante | L'indirizzo e-mail del pagante verrà sempre raccolto durante l'interazione SRC. Se si conosce già l'indirizzo email del pagante, aggiungere customer.email :<l'indirizzo email del pagante> al Checkout.configure() per consentire al pagante di evitare l'inserimento del proprio indirizzo e-mail durante l'interazione SRC. |
<html> <head> <script src="https://eu-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 come opzione di checkout nella propria pagina di pagamento
Se si sta utilizzando la propria pagina di pagamento e si desidera offrire SRC come opzione di checkout ai propri paganti, utilizzare l'SDK JavaScript SRCI (srci.js) fornito dal gateway.
Si tratta di un'integrazione JavaScript lato client che consente di avviare l'interazione SRC direttamente dal browser del pagante e garantisce che i dettagli di pagamento selezionati dal pagante durante l'interazione SRC vengano inviati direttamente dal browser del pagante al gateway.
Per utilizzare l'SDK SRCI JavaScript, seguire i passaggi indicati di seguito.
Passaggio 1: Creazione di una sessione
Creazione di una sessione inviando una richiesta Create Session
dall'applicazione lato server. La risposta restituisce un ID di sessione che è necessario utilizzare nei passaggi successivi per fare riferimento a questa sessione.
Passaggio 2: Aggiornamento della sessione con l'importo e la valuta dell'ordine
Aggiornare la sessione con almeno la valuta e l'importo dell'ordine inviando una richiesta Update Session
dall'applicazione lato server. Questo passaggio è necessario per richiedere successivamente la disponibilità di SRC per i pagamenti con questa valuta.
URL | https://eu-gateway.mastercard.com/api/rest/version/72/merchant/<your_merchant_ID>/session/<your_session_ID> |
Metodo HTTP | PUT |
{ "order":{ "amount":100.00, "currency":"USD" } }
Passaggio 3: inclusione dell'SDK JavaScript SRCI nella propria pagina di pagamento
Includere l'SDK JavaScript SRCI (srci.js) fornito dal gateway nella pagina di pagamento aggiungendo un elemento script
all'interno dell'elemento head
. Questo posizionerà un oggetto SRCi
nello spazio dei nomi della finestra.
<script type="text/javascript" src="https://eu-gateway.mastercard.com/static/srci/1.2.0/srci.min.js"></script>
Passaggio 4: configurazione dell'interazione SRC
Quando si carica la propria pagina di pagamento, avviare l'interazione SRC invocando il metodo SRCi.configure()
.
<html> <head> <script type="text/javascript" src="https://eu-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>
Dettagli esercente
È necessario il merchantId
affinché il gateway possa determinare correttamente le opzioni di pagamento.
I campi merchantName
e merchantUrl
vengono inviati al server SRC. Questi dettagli possono essere presentati al pagante durante l'interazione SRC.
Fornire il proprio nome commerciale, ovvero il nome noto al pagante e l'URL del proprio sito web che il pagante sta utilizzando.
Versione
Impostare questo valore su 57. Questa è la versione utilizzata quando è stata inviata la richiesta Create Session
.
Callback
Utilizzare il parametro callback
per definire le azioni da richiamare dopo il completamento di SRCi.configure()
. Ad esempio, si potrebbe voler accedere se il metodo ha avuto esito positivo:
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"); } }
La chiamata SRCi.configure()
potrebbe restituire le seguenti risposte di errore:
response.cause |
resp.explanation |
Azione richiesta |
---|---|---|
Errore | Argomento mancante: Merchant ID, Merchant Name, Merchant URL, Hosted Session ID e una funzione di callback sono tutti argomenti obbligatori per il metodo configure() . |
Correggere l'integrazione. È necessario fornire tutti i campi obbligatori della richiesta |
Errore | Argomento mancante: l'URL dell'esercente è un argomento obbligatorio per il metodo configure() |
Correggere l'integrazione. È necessario fornire il campo URL dell'esercente. |
Errore | Il callback deve essere una funzione. | Correggere l'integrazione. |
Errore | La versione API deve essere <MIN_VERSION> o superiore. |
Correggere l'integrazione. Impostare wsVersion su 57. |
Se viene restituito un errore, non procedere al passaggio successivo. Offrire al pagante un'altra modalità di pagamento.
Configurazione avanzata
L'SDK recupera i dettagli sulla configurazione del proprio profilo dell'esercente per SRC (incluso, ad esempio, l'elenco di tutti i circuiti per cui SRC è disponibile) utilizzando l'operazione Payment Options Inquiry
. Tuttavia, se è già stata inviata una richiesta Payment Options Inquiry
in precedenza durante la sessione del pagante, è possibile trasmettere questi dettagli aggiungendo l'elemento configuration
alla richiesta.
In questo caso, l'SDK non esegue nuovamente la richiesta Payment Options Inquiry
. Il parametro wsVersion
indica la versione DirectAPI utilizzata per inviare la richiesta Payment Options Inquiry
.
<html> <head> <script type="text/javascript" src="https://eu-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>
Risposta SRCi.configure()
di esempio
Il seguente esempio mostra una chiamata SRCi.configure()
con esito positivo.
{ result: "SUCCESS" restApiResponse: <Payments Options Inquiry response> }
La risposta contiene la risposta Payments Options Inquiry
nel campo restApiResponse
, che è solo informativo. Tuttavia, è possibile utilizzare queste informazioni in un secondo momento durante la sessione del pagante invece di utilizzare la richiesta PAYMENT_OPTIONS_INQUIRY
per recuperarle.
Il seguente esempio mostra una chiamata SRCi.configure()
non riuscita.
{ result: "ERROR" cause: <cause> explanation: <explanation> }
In questo caso, richiedi al pagante di selezionare un'altra opzione di checkout.
Passaggio 5: visualizzare SRC come opzione di checkout
Se SRCi.configure()
ha avuto esito positivo, visualizzare SRC come opzione di checkout nella pagina di pagamento. Per i requisiti del marchio, vedere Linee guida per l'interfaccia utente SRC.
Utilizzare i dettagli di configurazione SRC restituiti nella risposta Payment Options Inquiry
per determinare quali loghi dei circuiti visualizzare all'interno del pulsante. Per ogni circuito supportato, la risposta Payment Options Inquiry
contiene il nome del circuito nel campo paymentTypes.card.walletProviders[n].secureRemoteCommerce.scheme[n].name
.
Passaggio 6: avvio dell'interfaccia utente SRC
Quando il pagante seleziona SRC come opzione di checkout, avviare l'interfaccia utente SRC invocando il metodo 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 );
Oltre ai campi obbligatori, è possibile anche fornire una serie di campi facoltativi:
SRCi.launchUI( { "orderAmount":"60" "orderCurrency":"USD", "customerEmail":"<payer_email_address>", "collectShippingAddress":true, "interactionCountry":"CAN" "interactionLocale":"fr" } );
Raccolta indirizzo e-mail del pagante
L'indirizzo e-mail del pagante verrà sempre raccolto durante l'interazione SRC. Se già si conosce l'indirizzo email del pagante, aggiungere il campo customerEmail
al metodo SRCi.launchUI()
per consentire al pagante di evitare l'inserimento del proprio indirizzo email durante l'interazione SRC.
Raccolta indirizzo di fatturazione
Durante l'interazione SRC verrà sempre raccolto un indirizzo di fatturazione.
Raccolta indirizzo di spedizione
Per impostazione predefinita, SRC non raccoglierà l'indirizzo di spedizione del pagante. Se si desidera che SRC raccolga l'indirizzo di spedizione del pagante, aggiungere collectShippingAddress:true
al metodo SRCi.launchUI()
.
Per impostazione predefinita, il pagante può selezionare qualsiasi paese per l'indirizzo di spedizione. Per limitare l'elenco dei paesi in cui si spediscono i beni, è necessario configurare il proprio profilo dell'esercente per SRC tramite Merchant Administration con un elenco di paesi consentiti o un elenco di paesi esclusi. Nel caso siano state definite delle restrizioni, il pagante potrà selezionare solo un paese dell'indirizzo di spedizione consentito.
Non è possibile sostituire i paesi dell'indirizzo di spedizione supportati per una richiesta specifica.
Paese di interazione
Il paese di interazione determina il contenuto specifico del paese presentato al pagante durante l'interazione SRC, come ad esempio Termini e condizioni. Per impostazione predefinita viene utilizzato il valore configurato dall'esercente associato al proprio profilo dell'esercente nel gateway. Aggiungere il campo interactionCountry
al metodo SRCi.launchUI()
, se si desidera ignorare questo valore per questa interazione.
Lingua di interazione
La lingua di interazione determina la lingua utilizzata durante l'interazione SRC. Per impostazione predefinita, viene utilizzata la lingua configurata nel browser del pagante. Se la lingua del pagante non può essere determinata o non è supportata, viene utilizzata la lingua en_US. Se si desidera sovrascrivere questo valore, aggiungere il campo interactionLocale
al metodo SRCi.launchUI()
. Attualmente, le lingue supportate sono inglese (Regno Unito) (en_UK), spagnolo (Spagna) (es_ES), francese (Canada) (fr_CA), portoghese (Brasile) (pt_BR) e cinese (Hong Kong) (zh_HK).
Callback
È necessario definire le azioni da richiamare dopo il completamento di SRCi.launchUI()
come segue:
payloadCallback |
Funzione di callback da attivare quando il pagante ha completato l'interazione nell'interfaccia utente SRC. Questa funzione utilizza due argomenti, correlationId e scheme
Questi dettagli devono essere successivamente utilizzati per recuperare i dettagli di pagamento per questa interazione SRC (vedere il passaggio 7). |
|||||||||||||||||||||
errorCallback |
La funzione di callback da attivare se si verifica un errore durante il caricamento dell'interfaccia utente SRC. Questa funzione utilizza un argomento che verrà popolato con un oggetto errore contenente i dettagli dell'errore.
|
|||||||||||||||||||||
cancelCallback |
La funzione di callback da attivare quando il pagante annulla l'interazione SRC o l'interfaccia utente SRC viene chiusa. Non utilizza argomenti. |
Passaggio 7: Update Session con i dettagli di pagamento SRC
Dopo che il pagante ha completato con successo l'interazione SRC, è necessario richiedere al gateway di recuperare i dettagli di pagamento per l'interazione SRC e archiviarli nella sessione.
Inviare una richiesta Update Session From Wallet
con:
- l'ID di sessione nell'URL della richiesta e
- il
correlationId
e circuito restituiti nelpayloadCallback
URL | https://eu-gateway.mastercard.com/api/rest/version/72/merchant/<your_merchant_ID>/session/<your_session_ID> |
Metodo HTTP | POST |
{ "apiOperation":"UPDATE_SESSION_FROM_WALLET", "order":{ "walletProvider":"SECURE_REMOTE_COMMERCE" }, "wallet":{ "secureRemoteCommerce":{ "srcCorrelationId":"<correlationId_provided_in_payloadCallback>", "scheme":"<scheme_provided_in_payloadCallback>" } } }
Se la sessione è stata aggiornata con successo con i dettagli del pagamento dall'interazione SRC, è possibile procedere. Se la sessione non è stata aggiornata correttamente, chiedere al pagante di selezionare un'altra opzione di checkout.
Passaggio 8: esecuzione dell'autenticazione 3-D Secure (opzionale)
Se si desidera autenticare il pagante, eseguire l' Autenticazione 3-D Secure utilizzando la sessione. Per i dettagli, vedere Implementazione di un'integrazione 3DS utilizzando l'API JavaScript 3DS.
Passaggio 9: Esecuzione dell'operazione di pagamento
Se la sessione è stata aggiornata correttamente con i dettagli del pagamento dall'interazione SRC (e l'autenticazione 3-D Secure, se eseguita nel passaggio 8), utilizzare la sessione per inviare il pagamento per l'elaborazione dall'applicazione lato server. Ad esempio, è possibile inviare una richiesta Authorize
. I dettagli di pagamento archiviati nella sessione dall'interazione SRC vengono utilizzati per elaborare il pagamento. È possibile utilizzare la sessione per una serie di operazioni API; vedere Uso di una sessione per maggiori informazioni.
URL | https://eu-gateway.mastercard.com/api/rest/version/72/merchant/<your_merchant_ID>/order/<your_order_ID>/transaction/<your_transaction_ID> |
Metodo HTTP | PUT |
{ "session":{ "id":"<session_ID>" } "..." }
Il seguente codice di esempio HTML mostra come integrare SRCi.js nella propria pagina di pagamento. Tenere presente quanto segue:
SRCi.configure()
deve essere chiamato immediatamente dopo lo scriptsrci.min.js
viene caricato nella pagina. Il tentativo di chiamareSRCi.configure()
all'interno del gestore dei clic sui pulsanti, determinerà il blocco dell'apertura della finestra di pagamento SRC da parte di alcuni browser.- Il gestore dell'evento del pulsante "Paga" deve prima verificare che l'SDK JavaScript sia completamente configurato. Il tentativo di chiamare
SRCi.launchUI()
prima di una configurazione corretta genererà errori e avrà un impatto negativo sull'esperienza del pagante. - Il pulsante "Paga" dovrebbe essere disabilitato subito prima di chiamare SRCi.launchUI () e riattivato in ciascuno dei callback. Il tentativo di chiamare
SRCi.launchUI()
più volte può provocare un comportamento imprevisto.
<html> <head> <script type="text/javascript" src="https://eu-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>
Dettagli relativi ai pagamenti SRC
Questa sezione descrive i dettagli di pagamento restituiti per le interazioni SRC.
Tipo di dettagli di pagamento restituiti per le interazioni SRC
SRC supporta la restituzione di diversi tipi di dettagli di pagamento per l'elaborazione. I dettagli di pagamento restituiti dal sistema SRC dipendono dal tipo richiesto dal gateway, dalla configurazione nel sistema SRC e dal circuito della carta. SRC restituisce in genere un token di rete, una scadenza del token e un crittogramma completo (se supportato dal circuito della carta).
Tuttavia, se il gateway non è in grado di inviare un token di rete con crittogramma completo all'acquirer, SRC deve invece fornire un token di rete, una scadenza del token e un codice CSC (Card Security Code) dinamico. Il gateway garantirà automaticamente che venga richiesto il tipo corretto di dettagli di pagamento.
Se una carta non supporta la tokenizzazione di rete (ad esempio, se l'issuer non partecipa), SRC restituisce i dettagli della carta (numero e scadenza della carta) invece dei dettagli del token di rete (token di rete, scadenza del token e crittogramma o CSC dinamico).
Se si è un esercente statunitense e si è indicato di voler far valere i propri diritti ai sensi dell'emendamento Durbin, SRC fornisce i dettagli della carta (numero e scadenza della carta) per le carte di debito.
Dettagli del pagamento SRC nella risposta di transazione API
I dettagli di pagamento selezionati dal pagante durante l'interazione SRC vengono memorizzati nella sessione e restituiti nella risposta di transazione per le richieste API eseguite utilizzando la sessione. Quando SRC fornisce i dettagli del token di rete, vengono forniti sia i dettagli del token di rete che i dettagli della carta (mascherati).
A seconda del tipo di dettagli di pagamento restituiti dal sistema SRC, si riceveranno i seguenti dettagli nella risposta API.
Token di rete con crittogramma completo (American Express non supporta questo tipo di token di rete) (Il crittogramma non viene restituito nelle risposte di transazione) |
|
Token di rete con CSC dinamico (Il CSC non viene restituito nelle risposte di transazione) |
|
Numero e scadenza della carta di credito. |
|
Dettagli del pagante
Il nome e il numero di telefono del pagante sono forniti nella risposta di transazione nel gruppo di parametri customer
.
L'indirizzo e-mail del pagante è fornito nella risposta di transazione nel campo customer.email
, se consumerEmailAddressRequested
è stato impostato su true.
Dettagli indirizzo di fatturazione
I dettagli dell'indirizzo di fatturazione associati alla carta sono forniti nella risposta di transazione nel gruppo di parametri billing.address
.
Dettagli indirizzo di spedizione
Se collectShippingAddress
è stato impostato su true
, i dettagli dell'indirizzo di spedizione sono forniti nella risposta di transazione nel gruppo di parametri shipping.address
.
Transazioni avviate dall'esercente
Non si deve offrire SRC come opzione di checkout ai propri paganti se si desidera utilizzare successivamente tali dettagli di pagamento per avviare pagamenti in una serie, come pagamenti periodici o rateali. Questa opzione sarà supportata in una versione futura.
Test dell'integrazione
Dopo aver completato l'integrazione con il gateway per SRC, è possibile testarla utilizzando il proprio profilo esercente di prova (l'ID esercente preceduto da TEST
). Quando si utilizza il profilo esercente di prova, il gateway fornisce un simulatore per l'interazione SRC. Il simulatore SRC utilizza una serie di dettagli di pagamento predefiniti che non possono essere modificati. In base ai dettagli di pagamento predefiniti, è possibile attivare e testare diversi scenari, come descritto di seguito.
La seconda colonna nelle tabelle seguenti indica le ultime 4 cifre di FPAN selezionate dal pagante durante l'interazione SRC. Per attivare uno scenario, selezionare il FPAN corrispondente sul simulatore durante l'interazione SRC del pagante.
Circuito | Ultime 4 cifre del FPAN | ID correlazione SRC | Risposta API UPDATE_SESSION_FROM_WALLET risultante | Risposta API AUTHORIZE o PAY risultante |
---|---|---|---|---|
Mastercard | xxx0007 | 783a935d-c6a9-4289-b19d-c3336f998b57 |
|
|
Visa | xxx0003 | 12345671-visaTAVV-expiry0822-colShiptrue |
|
|
Circuito | Ultime 4 cifre del FPAN | ID correlazione SRC | Risposta API UPDATE_SESSION_FROM_WALLET risultante | Risposta API AUTHORIZE o PAY risultante |
---|---|---|---|---|
Mastercard | xxx0008 | 261af700-e576-43bf-af92-bd0f6810e8fb |
|
|
Visa | xxx0002 | 12345671-visaDTVV-expiry0822-colShiptrue |
|
|
American Express | xxx0017 | cf3de1e0-55a2-44cf-9563-5ef9e648c492 |
|
|
Circuito: | Ultime 4 cifre del FPAN | ID correlazione SRC | Risposta API UPDATE_SESSION_FROM_WALLET risultante | Risposta API AUTHORIZE o PAY risultante |
---|---|---|---|---|
Mastercard | xxx0305 | 8e455e8b-4e52-46cf-a3da-83aa3cf9a76e |
|
|
Visa | xxx0001 | 12345671-visa1-expiry0822 |
|
|
American Express | xxx4564 | bb978084-42b7-4985-af9d-2e41ee0a370c |
|
|
Test di SRC con 3-D Secure Authentication
Se il proprio profilo esercente è abilitato per l'Autenticazione sicura EMV 3-D (3DS2) è possibile utilizzare i dettagli del test SRC mostrati nella tabella seguente per attivare un flusso senza intoppi o un flusso di verifica.
Circuito: | Ultime 4 cifre del FPAN | ID correlazione SRC | Risposta API risultante |
---|---|---|---|
Mastercard | xxx0009 | 1049624e-cc67-45f6-bd5f-c625eb4c6cc1 |
|
Visa | xxx4222 | 12345671-SRC3DSChallenge-expiry0822-colShiptrue |
|
American Express | xxx0017 | 16e051bc-bd25-46db-a7d3-d2944fbb05cf |
|
Circuito | Ultime 4 cifre del FPAN | ID correlazione SRC | Risposta API risultante |
---|---|---|---|
Mastercard | xxx0010 | 16e051bc-bd25-46db-a7d3-d2944fbb05cf |
|
Visa | xxx4180 | 12345671-SRC3DSFrictionless-expiry0822-colShiptrue |
|
American Express | xxx4564 | 17e051bc-bd25-46db-a7d3-d2944fbb05cf |
|