- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Plățile mobile contactless
Plățile mobile contactless
Plățile mobile contactless sunt tranzacții autentificate cu ajutorul unui dispozitiv mobil (de ex., smartphone, tabletă, smartwatch) la un terminal contactless. Terminalul citește datele cardului de pe un cip contactless din dispozitivul mobil.
Un card de debit/credit adăugat unui cont de pe dispozitivul mobil al plătitorului este asociat unui simbol, iar dispozitivului îi este alocat un identificator specific acestuia, numit DPAN (PAN dispozitiv). DPAN este transformat într-un identificator FPAN (PAN finanțare) de către procesorul de plăți.
FPAN este numărul de cont principal (PAN) al cardului plătitorului. Acesta este numărul efectiv al cardului, înregistrat pentru DPAN și utilizat pentru procesarea tranzacției. Un FPAN poate fi asociat cu mai multe DPAN.
O plată mobilă contactless este inițiată de către terminalul contactless și trimisă către gateway sub forma unei tranzacții de decontare, autorizare, plată sau rambursare. De exemplu, tranzacțiile autorizate offline de către cipul dispozitivului mobil vor fi trimise exclusiv ca tranzacții de decontare, în timp ce tranzacțiile care necesită autorizația emitentului vor utiliza o tranzacție de autorizare online și apoi una de decontare.
Cerințe preliminare
- Your payment service provider și achizitorul dvs. trebuie activeze tranzacțiile cu posesorul cardului prezent.
- Trebuie să aveți un terminal cu plăți contactless activate.
Câmpuri comune utilizate pentru tranzacțiile mobile contactless
Următoarele câmpuri din API sunt aplicabile plăților mobile contactless efectuate prin intermediul gateway-ului.
transaction.source=CARD_PRESENT: Dacă nu completați acest câmp, va fi utilizată sursa implicită a tranzacției, configurată în legătura dvs. achizitor de către your payment service provider. [REST][NVP]sourceOfFunds.provided.card.emvRequest: Furnizați etichetele EMV citite de pe cip și acceptate de gateway. Consultați Câmpurile tranzacțiilor EMV.
Eticheta 9F1C (identificatorul terminalului) trebuie introdusă în acest câmp.
Asigurați-vă că valorile următoarelor câmpuri pentru terminalul POS sunt setate corect, în funcție de modul în care terminalul a generat datele cardului pentru tranzacție. Dacă datele pentru aceste câmpuri sunt disponibile, furnizați-le întotdeauna. Gateway-ul va transmite datele conform cerințelor achizitorului. Dacă achizitorul solicită un câmp care nu este prezent, tranzacția va eșua.
posTerminal.addressposTerminal.attended: Dacă nu completați acest câmp, gateway-ul va utilizaUNKNOWN_OR_UNSPECIFIEDca valoare implicităposTerminal.authorizationMethodposTerminal.cardHolderActivated: Dacă nu completați acest câmp, gateway-ul va utilizaNOT_CARDHOLDER_ACTIVATEDca valoare implicităposTerminal.inputCapability: Acest câmp este obligatoriu pentru tranzacțiile EMV.posTerminal.location: Acest câmp este obligatoriu pentru tranzacțiile EMV.posTerminal.panEntryModeposTerminal.pinEntryCapabilityposTerminal.onlineReasonCode: Acest câmp este obligatoriu pentru tranzacțiile cu cip și cele de rezervă (inclusiv stornările) în cazul tuturor tranzacțiilor online.posTerminal.serialNumberorder.gratuityAmount: Completați acest câmp dacă plata include o gratuitate.
[REST][NVP]order.cashbackAmount: Completați acest câmp dacă plata include o sumă restituită.
[REST][NVP]order.cashAdvance: Completați acest câmp dacă plata include un avans în numerar.
[REST][NVP]
Referință API Terminal POS [REST][NVP]
Răspuns de tranzacție
Când cartografierea DPAN la FPAN este efectuată cu succes, răspunsul RETRIEVE_TRANSACTION pentru plata mobilă contactless va returna:
- 6.4 FPAN ascuns, dacă este disponibil pentru achizitor, în câmpul
sourceOfFunds.provided.card.number. Pentru furnizorii de servicii de transport în comun, poate fi returnat un FPAN complet. Consultați Plățile cu costuri de transport agregate. - Expirarea FPAN, dacă este disponibilă pentru achizitor, în câmpul
sourceOfFunds.provided.card.expiry. - DPAN ascuns, în câmpul
sourceOfFunds.provided.card.deviceSpecificNumber
Dacă configurația dvs. prevede primirea PAN vizibile în răspunsul la tranzacție, gateway-ul va returna un DPAN vizibil și un FPAN vizibil (fie 6.4 ascuns, fie vizibil, în funcție de compatibilitatea cu achizitorul).