Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Quando si eseguono alcune chiamate al servizio Mastercard GatewayDirectAPI (ad esempio, Pay, Authorize, Refund, Capture, Save, Initiate Authentication, Authenticate Payer), è necessario fornire i dettagli della carta. Tali dettagli devono essere specificati utilizzando alcune "origini".
Se un dettaglio della carta, ad esempio il numero della carta, viene fornito più volte in una singola richiesta perché è contenuto in due o più origini, le regole di precedenza determineranno quale origine verrà utilizzata. L'ordine di precedenza è il seguente:
Questo significa che i dati contenuti nei campi della richiesta DirectAPI avranno la precedenza sui dati archiviati nella sessione, che a loro volta avranno la precedenza sui dettagli del token.
Se, ad esempio, si includono sia un identificativo di sessione (che contiene il numero, la data di scadenza e il codice di sicurezza della carta) che il token (che contiene il numero e la data di scadenza della carta) in una richiesta Pay, in base all'ordine di precedenza, nella transazione finanziaria verranno utilizzati i dettagli della carta specificati nell'identificativo di sessione.
Riferimento API per l'origine dei fondi[REST][NVP]
È possibile specificare i dettagli di pagamento utilizzando una di queste origini o una loro combinazione.
Si desidera inviare un'operazione Pay utilizzando il numero e la data di scadenza della carta archiviati in un token e il codice di sicurezza della carta raccolto in una sessione. La richiesta di esempio che segue mostra come fornire sia il token sia le origini della sessione nella richiesta Pay:
Metodo HTTP | PUT |
URL | https://eu-gateway.mastercard.com/api/rest/version/72/merchant/<merchant>/order/<orderId>/transaction/<transactionId> |
JSON |
{ "apiOperation": "PAY", "session": { "id": "SESSION000177777777777777777777" }, "sourceOfFunds": { "token": "9999999999999999" }, "order": { "amount": "34.00", "currency": "AUD" } } |
Il metodo JSON sopra riportato si basa sul seguente presupposto:
Si desidera aggiornare la data di scadenza riportata su un token archiviato mediante l'operazione Tokenization, senza tuttavia modificare il numero della carta. Il token fornito nell'URL della richiesta identifica il token che si desidera aggiornare. Se si fornisce lo stesso token come origine dei dettagli di pagamento, verranno riutilizzati i dettagli archiviati in precedenza e pertanto non sarà necessario acquisire nuovamente il numero della carta. Se si specifica la nuova data di scadenza nella sezione Dettagli carta della richiesta, il valore sostituirà la data di scadenza già archiviata nel token della carta (vedere Regole di precedenza di seguito).
La richiesta di esempio che segue mostra come fornire sia i dettagli di pagamento sia le origini del token nell'operazione Tokenization:
Metodo HTTP | PUT |
URL | https://eu-gateway.mastercard.com/api/rest/version/72/merchant/<merchant>/token/9999999999999999 |
JSON |
{ "sourceOfFunds": { "provided": { "card": { "expiry": { "month": "05", "year": "13" }, "number": "5123456789012346" } }, "type": "CARD" } } |
Il metodo JSON sopra riportato si basa sul seguente presupposto:
Il risultato di questa operazione è che il token "9999999999999999" ora ha come data di scadenza il 13/05 e il numero della carta rimane invariato.