API vă permite să transmiteți date suplimentare în cadrul tranzacțiilor. Acestea pot include date referitoare la domeniul de activitate, cum ar fi cele despre o linie aeriană sau serviciile medicale, sau date referitoare la tranzacție (internet, comandă sau chiar date personalizate). Datele suplimentare pe care le transmiteți pentru o tranzacție sunt stocate în eGenius Platform și asociate tranzacției respective.
Datele unei linii aeriene includ detalii privind zborul sau setul de zboruri, referința de rezervare, itinerariu, detalii privind pasagerii, detalii privind biletele etc.
Puteți specifica detalii privind mai mulți pasageri și mai multe segmente de călătorie asociate biletului. Numerotarea pentru date pasager și date etapă itinerar începe cu 0. De exemplu, airline.itinerary.leg[0].<fieldname>. Trebuie să utilizați numere consecutive pentru date etape și pasageri și numerele trebuie să fie consecutive și să nu conțină repetiții.
Date linie aeriană sunt aplicabile operațiunilor Authorize, Pay, Capture și Refund. Dacă remiteți date de linie aeriană pentru o tranzacție inițială și aceleași date de linie aeriană se aplică tranzacțiilor ulterioare pentru comandă, trebuie să trimiteți aceleași date de linie aeriană pentru fiecare tranzacție ulterioară.
Datele Internet includ informații referitoare la sursa de tranzacție pentru tranzacțiile e-commerce. De exemplu, adresă e-mail client, adresă IP, nume gazdă etc. Acestea ajută procesul de autorizare pentru tranzacții Fără card fizic, deoarece emitentul poate utiliza aceste date pentru a evalua riscul tranzacției.
Date internet sunt aplicabile numai operațiunilor Authorize și Pay.
Datele comenzii și articolelor-rând includ informații despre comandă și articolele conținute în comandă, pe care le puteți furniza în solicitare și puteți opta pentru a fi afișate pentru plătitor (prin Hosted Checkout sau plățile în browser) înaintea confirmării plății. Anumite date privind comenzile și articolele-rând, dacă sunt furnizate într-o tranzacție, pot face ca aceasta să fie eligibilă pentru comisioane de procesare mai scăzute în cazul posesorilor de carduri corporative, de afaceri sau de achiziții. Pentru mai multe informații, consultați Datele de nivel II și de nivel III.
order.item[n].brand
order.item[n].category
order.item[n].description
order.item[n].name
order.item[n].quantity
order.item[n].unitPrice
, order.item[n].unitTaxAmount
sau order.item[n].unitDiscountAmount
) și dacă zecimalele din valoarea calculată depășesc unitățile secundare ale monedei plătitorului, gateway-ul va rotunji totalul folosind algoritmul de rotunjire a jumătății la un număr par. De exemplu, dacă avem valoarea 2,555 (cantitatea) înmulțită cu 3 (prețul unitar), ceea ce are ca rezultat produsul 7,665, iar moneda plătitorului (USD) are 2 unități secundare, valoarea rotunjită a articolului va fi de 7,66.order.item[n].sku
order.item[n].unitPrice
Această sumă este înmulțită cu order.item[n].quantity
pentru a calcula suma totală pentru articolul-rând. Dacă furnizați order.itemAmount
, suma totală a valorilor tuturor articolelor-rând TREBUIE să fie egală cu valoarea din order.itemAmount
.
order.item[n].unitTaxAmount
Această sumă este înmulțită cu order.item[n].quantity
pentru a calcula valoarea totală a taxelor pentru articolul-rând. Dacă furnizați order.taxAmount
, suma totală a valorilor taxelor pentru toate articolele-rând TREBUIE să fie egală cu valoarea din order.taxAmount
.
order.item[n].unitDiscountAmount
Această sumă este înmulțită cu order.item[n].quantity
pentru a calcula valoarea totală a reducerii pentru articolul-rând. Dacă furnizați order.discount.amount
, valoarea totală a reducerilor pentru toate articolele-rând TREBUIE să fie egală cu valoarea din order.discount.amount
.
order.item[n].name
, order.item[n].quantity
și order.item[n].unitPrice
pentru articolul respectiv.order.currency
(obligatoriu)order.id
order.description
order.shippingAndHandlingAmount
order.amount
(obligatoriu)Dacă nu furnizați acest câmp, însă furnizați oricare dintre valorile sub-totalurilor (order.itemAmount
, order.shippingAndHandlingAmount
, order.taxAmount
, order.gratuityAmount
, order.cashbackAmount
) și order.discount.amount
, această valoare este calculată ca sumă a valorilor sub-totalurilor, minus valoarea reducerii. Dacă furnizați atât acest câmp, cât și valorile oricăror sub-totaluri, valoarea din acest câmp TREBUIE să fie egală cu valoarea calculată.
order.itemAmount
Dacă nu furnizați acest câmp, dar furnizați orice date privind articolele-rând, această valoare este calculată ca sumă a valorilor totale ale articolelor (order.item[n].unitPrice
x order.item[n].quantity
) pentru toate articolele-rând. Dacă furnizați atât acest câmp, cât și valorile oricăror articole-rând, valoarea din acest câmp TREBUIE să fie egală cu valoarea calculată.
order.taxAmount
Dacă nu furnizați acest câmp, dar furnizați orice date privind articolele-rând, această valoare este calculată ca sumă a valorilor totale ale taxelor (order.item[n].unitTaxAmount
x order.item[n].quantity
) pentru toate articolele-rând. Dacă furnizați atât acest câmp, cât și valorile oricăror articole-rând, valoarea din acest câmp TREBUIE să fie egală cu valoarea calculată.
order.discount.amount
Dacă nu furnizați acest câmp, dar furnizați orice date privind articolele-rând, această valoare este calculată ca sumă a valorilor totale ale reducerilor (order.item[n].unitDiscountAmount
x order.item[n].quantity
) pentru toate articolele-rând. Dacă furnizați atât acest câmp, cât și valorile oricăror articole-rând, valoarea din acest câmp TREBUIE să fie egală cu valoarea calculată.
order.gratuityAmount
: Suma pe care plătitorul a ales să o plătească cu titlu de gratuitate sau recompensă în plus față de suma plătită pentru bunurile sau serviciile achiziționate de la dvs. Valoarea gratuității este inclusă în valoarea totală a comenzii, indicată în order.amount
.order.cashbackAmount
: Suma pe care plătitorul a ales să o primească în numerar, în plus față de suma plătită pentru bunurile sau serviciile achiziționate de la dvs. Valoarea sumei primite în numerar este inclusă în valoarea totală a comenzii, indicată în order.amount
.Datele comenzii și articolelor-rând sunt aplicabile pentru solicitările Authorize, Pay, Initiate Browser Payment, Confirm Browser Payment, Open Wallet și Hosted Checkout.
order.cashbackAmount și order.gratuityAmount se aplică numai solicitărilor Authorize și Pay.
Datele personalizate achizitor includ orice informații suplimentare solicitate de către achizitor, care nu pot fi transmise utilizând alte câmpuri de date disponibile. Datele personalizate sunt stocate într-o bază de date, care poate fi utilizată la crearea de rapoarte externe în raport cu eGenius Platform. Acest câmp trebuie să nu conțină date sensibile.
Date personalizate achizitor sunt aplicabile operațiunilor Authorize, Capture, Pay, Refund și Void.
Datele personalizate de risc includ orice informații suplimentare solicitate de către furnizorii terți de evaluare a riscului, care nu pot fi transmise utilizând alte câmpuri de date disponibile. Numele câmpurilor personalizate de risc trebuie introduse după cum ați stabilit cu furnizorul dvs. terț de evaluare a riscului. Câmpurile de date personalizate de risc sunt returnate în răspuns și pot fi utilizate în scopuri de raportare și analiză, conform necesităților. Câmpurile de date personalizate de risc trebuie să nu includă date sensibile.
Date personalizate de risc sunt aplicabile operațiunilor Authorize, Capture, Pay, Verify.
Datele personalizate comerciant includ orice informații suplimentare care vă sunt necesare, care nu pot fi transmise utilizând alte câmpuri de date disponibile. De exemplu, puteți transmite date personalizate comerciant legate de o regiune de vânzări utilizând order.custom.salesRegion, unde „salesRegion” poate fi orice câmp definit de dvs. Câmpurile de date personalizate sunt returnate în răspuns și pot fi utilizate în scopuri de raportare și analiză, conform necesităților.
Aceste date nu sunt necesare pentru eGenius Platform sau pentru achizitor pentru procesarea tranzacției și trebuie să nu includă date sensibile în niciunul dintre câmpurile de date personalizate ale comerciantului.
Date personalizate comerciant sunt aplicabile operațiunilor Authorize, Capture, Pay, Refund, Void, Verify, Referral, Update Authorization, Initiate Browser Payment, Confirm Browser Payment și Hosted Checkout.
Puteți trimite tranzacții de achitări de datorii către gateway dacă furnizorul dvs. de servicii de plată a activat pentru dvs. achitările de datorii pentru cel puțin o metodă de finanțare (CREDIT, DEBIT sau PLATĂ). Acolo unde gateway-ul nu poate determina metoda de finanțare pentru o tranzacție de achitare a unei datorii, tranzacția va fi respinsă.
Atunci când trimiteți o tranzacție de achitare a datoriilor către gateway, trebuie să furnizați un indicator de achitare a datoriei și este posibil să trebuiască să furnizați informații despre destinatarul plății. Datele destinatarului plății includ informații suplimentare despre persoana care primește fondurile. Aceste date pot fi trimise achizitorului și sunt utilizate pentru evaluarea riscului plății și, prin urmare, pentru reducerea tranzacțiilor frauduloase.
În plus față de câmpurile standard pentru o tranzacție Verify, Authorize sau Pay, furnizați următoarele câmpuri pentru a iniția o tranzacție de achitare a datoriilor:
order.purchaseType
: Setați acest câmp la DEBT_REPAYMENT. Acest câmp este obligatoriu.debtRepayment.paymentRecipient.accountIdentifier
debtRepayment.paymentRecipient.dateOfBirth
debtRepayment.paymentRecipient.lastName
debtRepayment.paymentRecipient.postcodeZip
Datele trimise sunt returnate în răspunsul la tranzacție — data nașterii și identificatorul contului vor fi ascunse.
Puteți furniza date privind serviciile medicale ca date pentru articolele-rând ale unei comenzi. Datele privind serviciile medicale includ detaliile articolelor achiziționate ca servicii medicale, cum ar fi controalele oftalmologice, lucrările stomatologice, rețetele sau altele (achiziții clinice). Trebuie să furnizați aceste date numai dacă vi se aplică și sunt acceptate de către achizitor.
Dacă trebuie să trimiteți date privind serviciile medicale, trebuie să furnizați toate informațiile de mai jos privind articolele de servicii medicale din tranzacție.
eGenius Platform trimite achizitorului suma valorilor tuturor articolelor-rând care țin de aceeași categorie de ramură de activitate. Valoarea pentru un articol-rând este: (Item Unit Price + Item Unit Tax Amount) * Item Quantity
. Achizitorul va primi câte o singură înregistrare pentru fiecare categorie de ramură de activitate.
Suma tuturor valorilor categoriilor de ramuri de activitate va fi trimisă ca sumă a articolelor comenzii. Dacă valoarea comenzii diferă de suma valorilor articolelor, tranzacția va fi respinsă.
Datele serviciilor medicale pot fi trimise prin tranzacții Authorize, Pay, Capture și Refund.
Datele descriptorului extrasului de cont (numite și date ale descriptorului dinamic) includ informațiile de contact furnizate de dvs. care vor apărea pe extrasele de cont ale plătitorului. Aceste date sunt trimise către achizitor și au prioritate în raport cu datele descriptorului înregistrate de achizitor. Dacă furnizați date parțiale privind descriptorul extrasului de cont într-o tranzacție, achizitorul va completa datele extrasului folosind datele descriptorului așa cum sunt înregistrate de achizitor.
Dacă trebuie să trimiteți date privind descriptorul extrasului de cont, puteți furniza toate informațiile de contact de mai jos ale companiei dvs. în cadrul tranzacției.
Datele trimise sunt returnate în răspunsul la tranzacție.
Datele descriptorului de extras de cont pot fi trimise numai prin operațiuni Authorize, Pay, Capture, Refund, Verify, Update Session și Pay with Session.
Datele de croazieră includ informații despre croazieră, pasagerii croazierei și pot include, de asemenea, date privitoare la alte domenii, precum liniile aeriene sau închirierea de autovehicule, dacă au fost achiziționate ca parte a pachetului de croazieră.
Dacă trebuie să trimiteți date privind o croazieră, puteți furniza următoarele informațiile privind croaziera în cadrul tranzacției.
cruise.bookingReference
cruise.company.address.*
cruise.company.contact.customerServicePhone
cruise.company.contact.companyPhone
cruise.travelAgentCode
cruise.travelAgentName
cruise.travelPackageItems
cruise.departureDate
cruise.returnDate
cruise.shipName
cruise.passenger[n].*
Datele croazierei pot fi trimise în cadrul operațiunilor Authorize, Pay, Capture, Refund, Create Checkout Session și Update Session.
Datele trimise sunt returnate în răspunsul la tranzacție.
Dacă sunteți un comerciant care remite tranzacții de achiziționare de criptomonede sau titluri de valoare cu risc ridicat, trebuie să informați emitentul, furnizând anumiți indicatori în solicitarea de tranzacție către gateway.
În plus față de câmpurile standard pentru o tranzacție Verify, Authorize sau Pay, furnizați câmpul order.purchaseType
pentru a indica o tranzacție cu titluri de valoare cu risc ridicat și criptomonedă. Puteți seta câmpul la oricare dintre următoarele valori:
CRYPTOCURRENCY
: Dacă aveți codul de comerciant MCC 6051 (Cvasi numerar—Comerciant sau instituții nefinanciare – Valută, Monede non-Fiat) și tranzacția vizează achiziționarea de criptomonedă.HIGH_RISK_SECURITIES
: Dacă aveți codul de comerciant MCC 6211 (Titluri de valoare—Brokeri/Distribuitori) și tranzacția vizează achiziționarea de titluri de valoare cu risc ridicat.Referință API pentru date indicator pentru titluri de valoare cu risc ridicat și criptomonedă[REST][NVP]
Tranzacțiile care implică debitarea unei sume de bani dintr-un cont pentru creditarea unui alt cont sunt numite tranzacții de finanțare a conturilor conform terminologiei eGenius Platform. Destinatarul poate fi aceeași persoană, o altă persoană sau o organizație. Dacă organizația dvs. de servicii pentru comercianți (MSO) a activat această funcție pentru dvs., puteți facilita următoarele tipuri de tranzacții de finanțare a conturilor pentru clienții dvs.:
Datele tranzacției de finanțare de conturi (AFT) includ informații despre tipul expeditorului, tipul destinatarului, tipul contului destinatar, metoda de finanțare a contului și scopul finanțării. Pot include, de asemenea, alte detalii ale destinatarului. Dacă trebuie să trimiteți date de finanțare a conturilor, în funcție de tipul de tranzacție trimis, trebuie să furnizați unele dintre informațiile de mai jos privind tranzacția sau toate aceste informații.
accountFunding.senderType:
Valorile posibile pentru acest câmp sunt PERSON, COMMERCIAL_ORGANIZATION, NON_PROFIT_ORGANIZATION și GOVERNMENT.accountFunding.senderIsRecipient:
Definește dacă expeditorul și destinatarul tranzacției de finanțare de conturi sunt identici sau diferiți. Dacă nu este furnizată nicio valoare, acest câmp utilizează valoarea implicită, FALSE.accountFunding.recipient.account.fundingMethod:
Valorile posibile pentru acest câmp sunt CHARGE, CREDIT și DEBIT. Dacă nu este furnizată nicio valoare, acest câmp utilizează valoarea implicită, UNKNOWN.accountFunding.recipient.stateProvinceCode:
Codul statului sau provinciei destinatar. Valoarea trebuie să corespundă celei de-a doua părți a codului ISO 3166-2. De exemplu,
accountFunding.recipient.account:
Detaliile contului destinatarului care va primi fondurile debitate de la expeditor în cadrul acestei tranzacții.accountFunding.purpose:
Valorile posibile pentru acest câmp sunt CRYPTOCURRENCY_PURCHASE, MERCHANT_SETTLEMENT și PAYROLL. Dacă nu este furnizată nicio valoare, se utilizează valoarea implicită, OTHER.accountFunding.recipient:
Detalii privind destinatarul fondurilor.accountFunding.recipient.account.identifierType:
Valorile posibile pentru acest câmp sunt CARD_NUMBER, BANK_ACCOUNT_NATIONAL, BANK_ACCOUNT_BIC, BANK_ACCOUNT_IBAN, EMAIL_ADDRESS, PHONE_NUMBER, SOCIAL_NETWORK_PROFILE_ID și STAGED_WALLET_USER_ID. Dacă nu este furnizată nicio valoare, se utilizează valoarea implicită, OTHER.accountFunding.recipient.account.identifier:
Identificatorul contului destinatar al plății, cum ar fi numărul de card sau numărul de cont bancar.accountFunding.recipient.firstName:
Prenumele destinatarului plății.accountFunding.recipient.lastName:
Numele destinatarului plății.accountFunding.recipient.country:
Țara destinatarului plății.accountFunding.recipient.postCodeZip:
Codul poștal sau ZIP al destinatarului plății.accountFunding.recipient.dateOfBirth:
Data nașterii destinatarului plății în format aaaa-ll-zz.accountFunding.reference:
Referința pentru tranzacția de finanțare a contului. Această referință este generată de Mastercard Payment Gateway.Datele tranzacțiilor de finanțare a conturilor pot fi trimise în cadrul operațiunilor Authorize, Authenticate_Payer, Capture, Create_Checkout_Session, Pay, Refund, Standalone capture, Standalone refund, Update Session operations și Verify. Datele trimise sunt returnate în răspunsul la tranzacție.
Referința API pentru datele tranzacțiilor de finanțare a conturilor[REST][NVP]
Selectați MCC-ul corespunzător pentru indicatorul de tip de tranzacție dacă instituția de origine este înregistrată pentru serviciul Mastercard MoneySend și trimite mesajul Solicitare de autorizare pentru tranzacții de finanțare și rambursări de tranzacții de finanțare. Pentru mai multe informații, consultați Broșura de referință rapidă pe MC Connect > Centrul de resurse tehnice (TRC) sau contactați banca achizitoare pentru a obține MCC-urile recomandate pentru diferite tipuri de tranzacții.
Integrare tranzacții finanțare contTrimiteți indicatorul corect de tip de tranzacție în timp ce vă integrați cu Tranzacțiile de finanțare a contului, asigurând MCC-ul corespunzător și câmpul de solicitare corect în API. MSO v-a permis să trimiteți tranzacții de finanțare a contului și a configurat ce tipuri de tranzacții de finanțare a contului aveți voie să trimiteți. Pentru mai multe informații despre MCC, câmpurile de solicitare și configurația MSO, consultați documentația de integrare MPGS sau contactați Asistența MPGS pentru asistență suplimentară.
Acest tabel descrie MCC-urile pentru tranzacțiile de finanțare inițiate de clienți.
Identificator tip de tranzacție
|
MCC 4829 – Money Transfer
|
MCC 6540 – tranzacție finanțare
|
MCC 6538 – tranzacții de finanțare pentru MoneySend
|
Transfer general de la persoană la persoană |
Valabil pentru F07 |
Valabil pentru F07 |
Valabil pentru C07 |
Transfer de persoană la persoană în contul de card |
Valabil pentru F08 |
Valabil pentru F08 |
- |
Acest tabel descrie MCC-urile pentru transferurile inițiate de clienți sau organizații.
Identificator tip de tranzacție |
MCC 4829 – Money Transfer |
MCC 6540 – tranzacție finanțare |
MCC 6538 – tranzacții de finanțare pentru MoneySend |
Transfer în propriul cont de debit sau preplătit |
Valabil pentru F64 |
Valabil pentru F64 |
- |
Plata facturii proprii cu cardul de credit |
Valabil pentru F54 |
Valabil pentru F54 |
Valabil pentru C54 |
Transfer pe propriul cont de portofel electronic |
Valabil pentru F61 |
Valabil pentru F61 |
- |
Transfer general în cont propriu |
Valabil pentru F52 |
Valabil pentru F52 |
Valabil pentru C52 |
Transfer general în cont propriu inițiat de organizații |
Valabil pentru F52 |
Valabil pentru F52 |
Valabil pentru C52 |
Transfer în propriul cont de portofel electronic inițiat de organizații |
Valabil pentru F61 |
Valabil pentru F61 |
- |
Transfer în contul propriu de card de debit sau preplătit inițiat de organizații |
Valabil pentru F64 |
Valabil pentru F64 |
- |
Plata facturii proprii cu cardul de credit, inițiată de organizații |
Valabil pentru F54 |
Valabil pentru F54 |
- |
Plată de afaceri |
Valabil pentru F55 |
Valabil pentru F55 |
Valabil pentru C55 |
Plăți guvernamentale/non-profit |
- |
- |
Valabil pentru C56 |
Decontare rapidă comerciant |
- |
- |
Valabil pentru C57 |
Transfer general între companii |
Valabil pentru F65 |
Valabil pentru F65 |
Valabil pentru C65 |
Copyright © 2023 UniCredit Bank