Integration Types
Altre funzionalità
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
I pagamenti con titolare carta presente (CHP) fanno riferimento alle transazioni che utilizzano un terminale POS (Point of Sale). Il terminale potrebbe leggere i dati della carta:
Il supporto per le opzioni sopra descritte è disponibile a partire da DirectAPI versione 40 e successive.
Un pagamento con titolare della carta presente (CHP) viene avviato da un terminale e inviato al gateway sotto forma di transazione Verify, Capture, Authorize, Pay o Refund. Ad esempio, le transazioni che sono autorizzate offline mediante il chip sulla carta saranno inviate solo come Capture, mentre le transazioni che richiedono l'autorizzazione dall'issuer utilizzeranno una transazione Authorize online e poi una transazione Capture.
Le transazioni CHP interagiscono con numerose altre funzioni del gateway. È possibile:
Il Your payment service provider e l'acquirer devono abilitare l'esercente per le transazioni con titolare della carta presente.
I seguenti campi API sono rilevanti per tutte le integrazioni con titolare della carta presente tramite il gateway.
transaction.source=CARD_PRESENT
: Se l'esercente non specifica questo campo, verrà utilizzata l'origine della transazione predefinita configurata sul proprio collegamento all'acquirer dal your payment service provider. [REST][NVP]
sourceOfFunds.provided.card.number
per le transazioni digitate.sourceOfFunds.provided.card.track1
e/o sourceOfFunds.provided.card.track2
per le transazioni con banda magnetica, oppure sourceOfFunds.provided.card.emvRequest
per transazioni contactless in cui i dati della carta sono nel formato banda magnetica.sourceOfFunds.provided.card.emvRequest
per transazioni EMV (contact/contactless) in cui i dati della carta sono nel formato EMV.sourceOfFunds.provided.card.p2pe.payload
per transazioni P2PE (Point-to-Point Encryption) in cui i dati della carta sono crittografati nel formato DUKPT. posTerminal.lane
per le transazioni digitate e le transazioni con banda magnetica.sourceOfFunds.provided.card.emvRequest
per transazioni EMV (contact/contactless) in cui i dati della carta sono nel formato EMV.Assicurarsi che i valori per i seguenti campi del terminale POS siano impostati correttamente in base al modo in cui il terminale ha generato i dati della carta per la transazione. Se i dati per questi campi sono disponibili, fornirli sempre. Il gateway inoltrerà i dati all'acquirer come richiesto. Se l'acquirer richiede un campo e questo non è presente, la transazione non andrà a buon fine.
posTerminal.address
posTerminal.attended
: Se non si immette un valore per questo campo, il gateway imposta automaticamente l'importo a UNKNOWN_OR_UNSPECIFIED
posTerminal.authorizationMethod
posTerminal.cardHolderActivated
: Se non si immette un valore per questo campo, il gateway imposta automaticamente l'importo a NOT_CARDHOLDER_ACTIVATED
posTerminal.inputCapability
: questo campo è obbligatorio per tutte le transazioni EMV.posTerminal.location
: questo campo è obbligatorio per tutte le transazioni EMV. posTerminal.panEntryMode
posTerminal.pinEntryCapability
posTerminal.onlineReasonCode
: questo campo è obbligatorio per le transazioni con chip in fallback (incluse le revoche) per tutte le transazioni online.posTerminal.serialNumber
posTerminal.mobile.cardInputDevice
: Questo campo è applicabile ai dispositivi mobili POS (mPOS) in cui il dispositivo è in grado di accettare il tocco sullo schermo o la tastiera fisica per l'immissione del PIN. Il PIN software deve essere utilizzato solo per i dispositivi che non dispongono di una tastiera fisica per supportare l'immissione del PIN. Per i requisiti di integrazione di mPOS, vedere Integrazione per utilizzare mPOS. Riferimento API per il terminale POS [REST][NVP]
order.gratuityAmount
: Fornire questo campo se il pagamento include un importo aggiuntivo.
[REST][NVP]
order.cashbackAmount
: Fornire questo campo se il pagamento include un importo di cashback.
[REST][NVP]
order.cashAdvance
: Fornire questo campo se il pagamento include un anticipo in contanti.
[REST][NVP]
Se i dati della carta sono stati letti dal chip della carta (solo carte EMV),
sourceOfFunds.provided.card.emvRequest
come oggetto JSON nel protocollo REST o come raccolta dei campi nel protocollo NVP (consentito se il terminale non fornisce tutti i tag EMV supportati).
sourceOfFunds.provided.card.emvRequest [REST][NVP]
Alcuni dei tag EMV supportati corrispondono ai concetti di pagamento principali, come ad esempio il numero di conto principale. Tali concetti sono riportati anche nei campi delle richieste API, come sourceOfFunds.provided.card.number
. Il manuale Riferimento API per i campi della richiesta API corrispondente riporta il loro collegamento nella descrizione. Ad esempio, la descrizione per sourceOfFunds.provided.card.number
contiene il testo "Questo campo corrisponde al tag EMV 5A".
Se i dati sono forniti come tag EMV, quindi non sarà necessario fornirli anche come campo della richiesta API. Il gateway completerà i campi della richiesta API corrispondente con i valori forniti nei tag EMV, laddove presenti, e utilizzerà tali valori per tutte le elaborazioni interne, per le comunicazioni con l'acquirer e nelle risposte delle transazioni. Ad esempio, se si invia sourceOfFunds.provided.card.emvRequest.9F1C con valore "Lane_03" allora all'acquirer sarà inviato posTerminal.lane con valore "Lane_03", che sarà restituito anche nella risposta della transazione.
Se necessario, è possibile decidere di fornire nella richiesta di transazione sia i tag EMV sia i campi delle richieste API corrispondenti. Vedere Uso avanzato: Dati della transazione sia nei tag EMV sia nei campi di richiesta API.
Di seguito è riportata una richiesta EMV di esempio in REST per una transazione Standalone Capture in cui l'autorizzazione è stata eseguita offline sul terminale.
URL | https://eu-gateway.mastercard.com/api/rest/version/72/esercente/{merchantId}/ordine/{orderid}/transazione/{transactionid} |
Metodo HTTP | PUT |
{ "apiOperation": "CAPTURE", "transaction": { "currency": "EUR", "amount": "10.99", "source": "CARD_PRESENT" }, "sourceOfFunds": { "type": "CARD", "provided": { "card": { "number": "5457210089020012", "expiry": { "month": "1", "year": "39" }, "emvRequest": { "82": "0000", "95": "0000000000", "9F02": "000000001099", "9A": "161021", "5F2A": "840", "9F1A": "840", "9F10": "06011103A000000A0100000000000BB0ABAD", "9F34": "1E0300", "9F36": "0002", "9C": "00", "9F26": "D1F722D47FCA8273", "9F27": "40", "9F37": "2A4E1690", "9F33": "E0B8C8" } } } }, "posTerminal": { "inputCapability": "CONTACTLESS_CHIP", "panEntryMode": "CHIP", "pinEntryCapability": "PIN_SUPPORTED", "location": "MERCHANT_TERMINAL_ON_PREMISES", "lane": "Lane_03", "attended": "ATTENDED", "serialNumber":"123456789", "onlineReasonCode":"FORCED_BY_MERCHANT", "cardPresenceCapability":"CARD_PRESENT", "authorizationMethod":"OFFLINE", "address": { "country":"IRL", "city":"Dublin" } } }
{ "gatewayEntryPoint": "WEB_SERVICES_API", "merchant": "TESTSMOKE-RETAIL", "order": { "amount": 10.99, "creationTime": "2017-06-06T09:42:54.280Z", "currency": "EUR", "id": "sa-dfc1b030-4520-48ec-a7e0-889999d7e4ab", "status": "CAPTURED", "totalAuthorizedAmount": 10.99, "totalCapturedAmount": 10.99, "totalRefundedAmount": 0 }, "posTerminal": { "address": { "city": "Dublin", "country": "IRL" }, "attended": "ATTENDED", "authorizationMethod": "OFFLINE", "cardPresenceCapability": "CARD_PRESENT", "cardholderActivated": "NOT_CARDHOLDER_ACTIVATED", "inputCapability": "CONTACTLESS_CHIP", "lane": "Lane_03", "location": "MERCHANT_TERMINAL_ON_PREMISES", "onlineReasonCode": "FORCED_BY_MERCHANT", "panEntryMode": "CHIP", "pinEntryCapability": "PIN_SUPPORTED", "serialNumber": "123456789" }, "response": { "gatewayCode": "APPROVED" }, "result": "SUCCESS", "sourceOfFunds": { "provided": { "card": { "brand": "MASTERCARD", "emvRequest": { "82": "0000", "95": "0000000000", "5F2A": "840", "9A": "161021", "9C": "00", "9F02": "000000001099", "9F10": "06011103A000000A0100000000000BB0ABAD", "9F1A": "840", "9F26": "D1F722D47FCA8273", "9F27": "40", "9F33": "E0B8C8", "9F34": "1E0300", "9F36": "0002", "9F37": "2A4E1690" }, "emvResponse": { "4D3E": "456", "5A2F": "123" }, "expiry": { "month": "1", "year": "39" }, "fundingMethod": "DEBIT", "issuer": "CAPITAL ONE BANK (CANADA BRANCH)", "number": "545721xxxxxx0012", "scheme": "MASTERCARD" } }, "type": "CARD" }, "timeOfRecord": "2017-06-06T09:42:54.280Z", "transaction": { "acquirer": { "batch": 1, "id": "FOOBANK", "merchantId": "11223344" }, "amount": 10.99, "currency": "EUR", "frequency": "SINGLE", "id": "1", "receipt": "1706063974", "source": "CARD_PRESENT", "terminal": "0001", "type": "CAPTURE" }, "version": "43" }
Di seguito è riportato un elenco dei tag EMV supportati dal gateway. Se uno di questi è restituito dal terminale, includerlo nel campo sourceOfFunds.provided.card.emvRequest
.
Tag EMV |
Nome |
Obbligatorio |
---|---|---|
4F | Nome identificativo applicazione (AID) | - |
56 | Traccia 1 | - |
57 | Dati equivalenti della traccia 2 | - |
5A | Numero conto principale (PAN) applicazione |
- |
5F24 | Data scadenza applicazione | - |
5F25 | Data di applicazione effettiva | - |
5F28 | Codice paese dell'issuer | - |
5F2A | Codice valuta transazione | - |
5F34 | Numero sequenziale PAN (applicazione del conto principale) |
- |
82 | Profilo commissione interbancaria applicazione (AIP) | Sì |
84 | Nome file dedicato | - |
87 | Indicatore di priorità applicazione | - |
95 | Risultato verifica terminale (TVR) | Sì |
9A | Data transazione | Sì |
9B | Informazioni sull'esito della transazione | - |
9C | Tipo di transazione | Sì |
9F02 | Importo autorizzato | Sì |
9F03 | Importo cashback | - |
9F06 | Nome identificativo applicazione (AID) - Terminale | - |
9F07 | Controllo utilizzo applicazione | - |
9F08 | Numero versione applicazione - ICC | - |
9F09 | Numero versione applicazione - Terminale | - |
9F0D | Codice azione dell'issuer - impostazione predefinita | - |
9F0E | Codice azione dell'issuer - Rifiuto | - |
9F0F | Codice azione dell'issuer - Online | - |
9F10 | Dati applicazione issuer (IAD) | Sì |
9F1A | Codice paese terminale | Sì |
9F1C | Identificazione terminale | - |
9F1E | Numero di serie Dispositivo interfaccia (IFD) | - |
9F21 | Ora transazione | - |
9F26 | Crittogramma applicazione (AC) | Sì |
9F27 | Dati informazioni crittogramma (CID) | Sì |
9F33 | Funzionalità terminale | - |
9F34 | Risultati metodo di verifica titolare della carta (CVM) | Sì |
9F35 | Tipo di terminale | - |
9F36 | Contatore transazione applicazione | Sì |
9F37 | Numero non prevedibile | Sì |
9F39 | Modalità di accesso POS (Point-of-Service) | - |
9F40 | Funzionalità aggiuntive terminale | - |
9F41 | Contatore sequenza transazione | - |
9F49 | Elenco oggetti dati di autenticazione dati dinamici (DDOL) | - |
9F53 | Codice categoria transazione | - |
9F5A | EMV (Kernel 3): identificativo programma applicazione (ID programma) EMV (Kernel 4): identificativo iscrizione prodotto |
- |
9F5B | EMV (Kernel 3): Risultati script issuer EMV (Kernel 2) : DSDOL EMV (Kernel 4): numero iscrizione prodotto |
- |
9F66 | EMV (Kernel 2): PUNATC(Track2) EMV (Kernel 3) : qualificatori della transazione terminale (TTQ) |
- |
9F6E | Indicatore fattore di forma | - |
9F7C | Dati esclusivi del cliente (CED) | - |
Se nella richiesta di transazione vengono forniti sia i tag EMV sia i campi della richiesta API corrispondenti, il gateway utilizzerà il valore fornito nel campo della richiesta API corrispondente. Ad esempio, se si invia sourceOfFunds.provided.card.emvRequest.9F1C con valore ‘Lane_03’ e posTerminal.lane con valore ‘Lane_04’, allora posTerminal.lane con valore ‘Lane_04’ sarà inviato all'acquirer e sarà restituito nella risposta della transazione. Ciò può risultare utile se si desidera sovrascrivere i tag EMV e i valori di controllo in base ai campi. Tenere presente che un tale uso è molto raro e pertanto va considerato solo se l'integrazione lo richiede.
In questa tabella sono riportati i tag EMV quando il gateway completa i campi della richiesta API corrispondenti con i valori forniti nei tag EMV.
Tag EMV |
Nome tag EMV |
Campo richiesta API corrispondente |
---|---|---|
56 | Traccia 1 | sourceOfFunds.provided.card.track1 |
57 | Dati equivalenti della traccia 2 | sourceOfFunds.provided.card.track2 |
5A | Numero conto principale (PAN) applicazione | sourceOfFunds.provided.card.number |
5F24 | Data scadenza applicazione | sourceOfFunds.provided.card.expiry.year sourceOfFunds.provided.card.expiry.month |
5F34 | Numero sequenziale PAN | sourceOfFunds.provided.card.sequenceNumber |
9C | Anticipo in contanti | order.cashAdvance |
9F03 | Importo cashback | order.cashbackAmount |
9F1A | Codice paese terminale | posTerminal.address.country |
9F1C | Identificazione terminale | posTerminal.lane |
9F1E | Numero di serie Dispositivo interfaccia | posTerminal.serialNumber |
9F33 | Funzionalità terminale | posTerminal.inputCapability posTerminal.pinEntryCapability |
9F35 | Tipo di terminale | posTerminal.attended posTerminal.cardholderActivated |
Il gateway restituisce il campo sourceOfFunds.provided.card.emvResponse
nella risposta di Retrieve Order e Retrieve Transaction. Questo campo contiene dati generati dall'issuer che possono essere utilizzati dalla carta e/o dal dispositivo per verificare il completamento o il rifiuto della transazione. Inoltre può contenere tag EMV aggiuntivi dall'issuer che includono tag rimbalzati dalla richiesta.
La tabella di seguito riporta alcuni tag EMV che possono essere restituiti in una risposta di autorizzazione online.
Tag EMV | Nome |
---|---|
8A | Codice risposta autorizzazione |
89 | Codice di autorizzazione |
91 | Dati di autenticazione issuer |
71 | Modello script issuer 1 |
72 | Modello script issuer 2 |
Il campo sourceOfFunds.provided.card.emvRequest
fornito nella richiesta viene rimbalzato nella risposta dove i tag EMV identificati come sensibili a PCI sono esclusi.
Quando si annulla una transazione EMV, l'acquirer potrebbe richiedere l'inclusione di altri elementi di dati EMV. Ad esempio, potrebbe essere richiesto il tag EMV DF01 (Risultati script issuer). Per ulteriori informazioni, contattare l'acquirer.
Se i dati di traccia della carta sono stati letti dalla banda magnetica della carta,
sourceOfFunds.provided.card.track1
o i dati di traccia 2 nel campo sourceOfFunds.provided.card.track2
. Se dal terminale sono disponibili sia la traccia 1 che la traccia 2, queste devono essere aggiunte entrambe alla richiesta di transazione.
sourceOfFunds.provided.card.track1 [REST][NVP]
sourceOfFunds.provided.card.track2 [REST][NVP]
Di seguito è riportato un esempio di transazione di autorizzazione online che utilizza dati della banda magnetica.
URL | https://eu-gateway.mastercard.com/api/rest/version/72/esercente/{merchantId}/ordine/{orderid}/transazione/{transactionid} |
Metodo HTTP | PUT |
{ "apiOperation": "AUTHORIZE", "order": { "amount": 80, "currency": "AUD" }, "transaction": { "source": "CARD_PRESENT", "frequency": "SINGLE" }, "sourceOfFunds": { "type": "CARD", "provided": { "card": { "number": "5457210089020012", "sequenceNumber": "015", "expiry": { "year": "39", "month": "01" }, "track2": ";5123456789012346=17051019681143384001?", "track1": "%B5123456789012346^MR JOHN R SMITH ^17051019681143300001 840 ?;" } } }, "posTerminal": { "lane": "AdamLane", "panEntryMode": "SWIPE", "pinEntryCapability": "PIN_NOT_SUPPORTED", "attended": "UNATTENDED", "cardholderActivated": "SELF_SERVICE_TERMINAL", "inputCapability": "MAGNETIC_STRIPE", "location": "MERCHANT_TERMINAL_OFF_PREMISES" } }
{ "authorizationResponse": { "posData": "1605S0100130", "transactionIdentifier": "AmexTidTest" }, "gatewayEntryPoint": "WEB_SERVICES_API", "merchant": "TESTSMOKE-RETAIL", "order": { "amount": 80, "creationTime": "2017-05-31T07:49:46.351Z", "currency": "AUD", "id": "sa-e229682a-2163-47cf-b080-fb60dd148192", "status": "AUTHORIZED", "totalAuthorizedAmount": 80, "totalCapturedAmount": 0, "totalRefundedAmount": 0 }, "posTerminal": { "attended": "UNATTENDED", "cardholderActivated": "SELF_SERVICE_TERMINAL", "inputCapability": "MAGNETIC_STRIPE", "lane": "AdamLane", "location": "MERCHANT_TERMINAL_OFF_PREMISES", "panEntryMode": "SWIPE", "pinEntryCapability": "PIN_NOT_SUPPORTED" }, "response": { "acquirerCode": "00", "gatewayCode": "APPROVED" }, "result": "SUCCESS", "sourceOfFunds": { "provided": { "card": { "brand": "MASTERCARD", "expiry": { "month": "1", "year": "39" }, "fundingMethod": "DEBIT", "issuer": "CAPITAL ONE BANK (CANADA BRANCH)", "number": "545721xxxxxx0012", "scheme": "MASTERCARD", "sequenceNumber": "015", "trackDataProvided": true } }, "type": "CARD" }, "timeOfRecord": "2017-05-31T07:49:46.351Z", "transaction": { "acquirer": { "batch": 1, "id": "SYSTEST_ACQ1", "merchantId": "12345678" }, "amount": 80, "authorizationCode": "000001", "currency": "AUD", "frequency": "SINGLE", "id": "1", "receipt": "1705313", "source": "CARD_PRESENT", "terminal": "0006", "type": "AUTHORIZATION" }, "version": "43" }
Se il numero della carta è stato immesso manualmente sulla tastiera del terminale,
sourceOfFunds.provided.card.number
.
sourceOfFunds.provided.card.number
[REST][NVP]
Di seguito è riportato un esempio di transazione di autorizzazione online che utilizza un numero di carta immesso manualmente.
URL | https://eu-gateway.mastercard.com/api/rest/version/72/esercente/{merchantId}/ordine/{orderid}/transazione/{transactionid} |
Metodo HTTP | PUT |
{ "posTerminal": { "serialNumber": "13130PP800781435", "cardholderActivated": "NOT_CARDHOLDER_ACTIVATED", "lane": "S2_Lane", "panEntryMode": "KEYED", "pinEntryCapability": "UNKNOWN", "attended": "ATTENDED", "inputCapability": "KEY_ENTRY", "location": "MERCHANT_TERMINAL_ON_PREMISES" }, "apiOperation": "AUTHORIZE", "sourceOfFunds": { "type": "CARD", "provided": { "card": { "number": "5457210089020012", "sequenceNumber": "000", "expiry": { "year": "39", "month": "01" } } } }, "order": { "amount": "100.00", "currency": "EUR" }, "transaction": { "source": "CARD_PRESENT", "frequency": "SINGLE" } }
{ "gatewayEntryPoint": "WEB_SERVICES_API", "merchant": "TESTSMOKE-RETAIL", "order": { "amount": 100, "creationTime": "2017-05-31T08:59:47.194Z", "currency": "EUR", "id": "sa-529e784a-e11d-474d-8012-c0790531bb0f", "status": "AUTHORIZED", "totalAuthorizedAmount": 100, "totalCapturedAmount": 0, "totalRefundedAmount": 0 }, "posTerminal": { "attended": "ATTENDED", "cardholderActivated": "NOT_CARDHOLDER_ACTIVATED", "inputCapability": "KEY_ENTRY", "lane": "S2_Lane", "location": "MERCHANT_TERMINAL_ON_PREMISES", "panEntryMode": "KEYED", "pinEntryCapability": "UNKNOWN", "serialNumber": "13130PP800781435" }, "response": { "gatewayCode": "APPROVED" }, "result": "SUCCESS", "sourceOfFunds": { "provided": { "card": { "brand": "MASTERCARD", "expiry": { "month": "1", "year": "39" }, "fundingMethod": "DEBIT", "issuer": "CAPITAL ONE BANK (CANADA BRANCH)", "number": "545721xxxxxx0012", "scheme": "MASTERCARD", "sequenceNumber": "000" } }, "type": "CARD" }, "timeOfRecord": "2017-05-31T08:59:47.194Z", "transaction": { "acquirer": { "batch": 1, "id": "FOOBANK", "merchantId": "11223344" }, "amount": 100, "authorizationCode": "471223", "currency": "EUR", "frequency": "SINGLE", "id": "1", "receipt": "170531475", "source": "CARD_PRESENT", "terminal": "0001", "type": "AUTHORIZATION" }, "version": "43" }
P2PE è uno standard stabilito dal PCI Security Standards Council (l'Ente responsabile degli standard di protezione). Con P2PE, i dati sensibili della carta sono crittografati sul terminale subito dopo la lettura della carta di credito. Questo ottimizza la sicurezza delle transazioni con titolare della carta presente, con una conseguente riduzione degli obblighi di conformità PCI per l'esercente, che non deve gestire i dati sensibili.
Per elaborare una transazione P2PE
sourceOfFunds.provided.card.p2pe.keySerialNumber
: È necessario fornire il numero di serie DUKPT fornito dal terminale. sourceOfFunds.provided.card.p2pe.payload
: Se si fornisce questo campo, sourceOfFunds.provided.card.number
non è obbligatorio. Il gateway estrapolerà i dettagli della carta rilevanti dai dati del payload forniti.posTerminal.serialNumber
: sourceOfFunds.provided.card.p2pe.cardBin
sourceOfFunds.provided.card.p2pe.encryptionState
: Se non si immette un valore per questo campo, il gateway imposta automaticamente l'importo a VALID
sourceOfFunds.provided.card.p2pe.initializationVector
: Questo campo può essere omesso se il terminale non sta utilizzando un vettore di inizializzazione per inviare una crittografia.Riferimento API per P2PE [REST][NVP]
Nella tabella che segue sono riportati i vincoli di campo per il gruppo di parametri: sourceOfFunds.provided.card.p2pe
.
Se il campo | allora il gateway... | ||
---|---|---|---|
sourceOfFunds.provided.card.p2pe. initializationVector |
sourceOfFunds.provided.card.p2pe. keySerialNumber |
sourceOfFunds.provided.card.p2pe. payload | |
viene fornito | viene fornito | non viene fornito | rifiuta la richiesta di transazione. |
viene fornito | viene fornito ma in testo semplice prima o dopo la crittografia | viene fornito | restituisce un errore e viene generata una voce del registro di sicurezza. |
Il campo sourceOfFunds.provided.card.encryption
restituisce DUKPT
(a partire da DirectAPI 43 e successive) nella risposta di transazione per indicare che i dati della carta sono stati crittografati. I campi nel gruppo di parametri sourceOfFunds.provided.card.p2pe
non vengono restituiti nella risposta.
I dati del PIN online immessi dal titolare della carta di credito sono crittografati all'origine, all'interno del dispositivo di immissione del PIN. Il Mastercard Gateway supporta unicamente i dati del PIN online crittografati con il sistema DUKPT (Derived Unique Key Per Transaction, Derivato Chiave Univoca per ogni transazione) a partire da DirectAPI versione 45.
sourceOfFunds.provided.card.pin.payload
sourceOfFunds.provided.card.pin.keySerialNumber
posTerminal.pinLengthCapability
sourceOfFunds.provided.card.pin.encryptionState
Il gateway supporta l'accettazione di pagamenti su dispositivi mobili POS (mPOS) a partire dalla versione 56 dell'API. Per abilitare la funzionalità, fornire quanto segue nella transazione Verify, Authorize, Capture, Pay, o Refund.
posTerminal.cardholderActivated
=MPOS_ACCEPTANCE_DEVICE
posTerminal.mobile.cardInputDevice
BUILT_IN
: Telefono cellulare o tablet disponibile in commercio con solo un lettore contactless integrato. In questo caso, posTerminal.pinEntryCapability deve essere impostato su SOFTWARE_ONLINE_PIN_ONLY altrimenti il gateway rifiuta la transazione.INTEGRATED_DONGLE
: Terminale mobile dedicato con lettore di carte integrato. In questo caso, posTerminal.pinEntryCapability deve essere impostato su PIN_SUPPORTED o OFFLINE_PIN_ONLY altrimenti il gateway rifiuta la transazione.SEPARATE_DONGLE
: Dispositivo standard o terminale mobile dedicato, con lettore di schede separato. In questo caso, posTerminal.pinEntryCapability deve essere impostato su PIN_SUPPORTED o OFFLINE_PIN_ONLY altrimenti il gateway rifiuta la transazione.L'autenticazione del PIN può fallire se il pagante immette un PIN non valido, supera il numero consentito di tentativi di immissione del PIN oppure omette l'immissione del PIN quando questo è necessario per completare una transazione.
In questi casi, in cui l'autorizzazione non riesce a causa di un errore di autenticazione del PIN, il gateway restituirà specifici codici di risposta. È possibile riutilizzare lo stesso ID dell'ordine per la transazione successiva.
È possibile testare la propria integrazione utilizzando carte di prova specifiche dell'acquirer.