Integration Types
Alte caracteristici
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Plățile cu costuri de transport agregate sunt tranzacții contactless trimise de furnizorii de transport pentru a agrega costurile tranzacțiilor plătitorului pentru mai multe călătorii, efectuate într-o anumită perioadă de timp, în limita unei anumite sume.
Pentru a trimite o plată cu costuri de transport agregate, trebuie să aveți unul dintre următoarele coduri de categorie comerciant (MCC):
Plățile cu costuri de transport agregate sunt acceptate numai pentru cardurile Mastercard (cu excepția cardurilor Maestro), Visa și American Express.
Trimiteți o solicitare de autorizare nominală către emitent, incluzând următoarele detalii:
order.amount
: Furnizați 1 USD sau costul minim.transaction.transit.fareCollection=AGGREGATION_ACROSS_TRIPS
Completarea acestui câmp și a acestei valori marchează autorizarea ca autorizare amânată. Pentru mai multe informații, consultați Amânările autorizărilor.
transaction.transit.transportationMode
: Furnizați modul de transport utilizat de plătitor la prima călătorie.sourceOfFunds.provided.card.emvRequest
: Furnizați etichetele EMV citite de pe cipul contactless și acceptate de gateway. Consultați Câmpurile tranzacțiilor EMV.Iată un exemplu (în REST) de autorizare nominală pentru agregarea costurilor de transport.
URL | https://egenius.unicredit.ro/api/rest/version/72/merchant/{merchantId}/order/{orderid}/transaction/{transactionid} |
Metoda HTTP | PUT |
{ "sourceOfFunds": { "type": "CARD", "provided": { "card": { "emvRequest": { "9F02": "123456738012", "5F2A": "125", "9F1A":"321", "9F27":"e1", "95": "123a567e90", "9A": "654321", "9F36": "1e34", "9C": "21", "9F26": "0123456789abcdef", "82": "12f4", "9F37": "F123f986" }, } } }, "apiOperation": "AUTHORIZE", "order": { "currency": "AUD", "amount": "1" }, "posTerminal": { "cardholderActivated": "NOT_CARDHOLDER_ACTIVATED", "inputCapability": "CONTACTLESS_CHIP", "panEntryMode" : "CONTACTLESS", "pinEntryCapability" : "PIN_NOT_SUPPORTED", "location": "MERCHANT_TERMINAL_OFF_PREMISES", "lane": "test", "attended": "UNATTENDED" }, "transaction": { "transit": { "fareCollection": "AGGREGATION_ACROSS_TRIPS", "transportationMode": "TRAIN" }, "source": "CARD_PRESENT", "frequency": "SINGLE" } }
Dacă tranzacția de autorizare are loc cu succes, puteți trimite o tranzacție de decontare pe baza comenzii, pentru agregarea costurilor ulterioare de transport pentru cardul respectiv la sfârșitul perioadei de facturare – de exemplu, o zi.
order.id
: Identificatorul comenzii pentru o tranzacție de autorizare efectuată cu succes.transaction.id
: Identificatorul tranzacției pentru tranzacția de decontare.transaction.amount
: Suma totală pentru toate călătoriile dintr-o anumită perioadă.transaction.currency
Nu este necesar să trimiteți din nou detaliile plății în tranzacția de decontare, deoarece gateway-ul le va stoca, asociate cu comanda.
sourceOfFunds.provided.card.number
: FPAN complet asociat cu DPAN, returnat de schema cardului în răspunsul de autorizare, în cazul în care cartografierea FPAN a fost efectuată cu succes și furnizată de către achizitor. sourceOfFunds.provided.card.expiry
: Data de expirare a FPAN.order.id
: Identificatorul comenzii pentru o tranzacție de autorizare efectuată cu succes.transaction.id
: Identificatorul tranzacției pentru tranzacția de decontare.transaction.amount
: Suma totală pentru toate călătoriile dintr-o anumită perioadă.transaction.currency
Când cartografierea DPAN la FPAN este efectuată cu succes, DPAN este returnat în câmpul sourceOfFunds.provided.card.deviceSpecificNumber
din răspunsul de autorizare, pentru a vă permite să identificați tranzacția drept tranzacție mobilă contactless. În cazul în care configurația dvs. permite primirea PAN-urilor vizibile în răspunsul la tranzacție, gateway-ul va returna un DPAN vizibil.
Dacă autorizarea unei plăți cu costuri de transport agregate eșuează, puteți încerca o plată de recuperare a datoriilor, pentru a rezolva orice datorii rămase la plătitor și a permite plătitorului să efectueze călătorii ulterioare.
Trimiteți o solicitare de tranzacție de autorizare pentru comanda cu autorizare eșuată sau pentru o nouă comandă cu:
transaction.transitFareCollection=DEBT_RECOVERY
transaction.transit.transportationMode
=<the transportation mode used by the payer for the first trip>order.amount=<fare for single trip only>
Poate fi util să creați un simbol pentru detaliile plății (numărul cardului, data expirării etc.) atunci când trimiteți autorizarea inițială a plății cu costuri de transport agregate, utilizând apoi simbolul pentru autorizarea plății de recuperare a datoriei în locul detaliilor plății.
sourceOfFunds.provided.card.number
: FPAN complet asociat cu DPAN, returnat de schema cardului în răspunsul de autorizare, în cazul în care cartografierea FPAN a fost efectuată cu succes și furnizată de către achizitor.sourceOfFunds.provided.card.expiry
: Data de expirare a FPAN.transaction.transitFareCollection=DEBT_RECOVERY
transaction.transit.transportationMode
: Modul de transport utilizat de plătitor la prima călătorie.order.amount
: Costul unei singure călătorii.Când cartografierea DPAN la FPAN este efectuată cu succes, DPAN este returnat în sourceOfFunds.provided.card.deviceSpecificNumber
, pentru a vă permite să identificați tranzacția drept tranzacție mobilă contactless. Dacă solicitați returnarea unui PAN vizibil în răspunsul la tranzacție, gateway-ul va returna un DPAN vizibil.