Un comision este o sumă suplimentară percepută de comerciant pentru a acoperi costurile acceptării plăților cu cardul. Funcționalitatea pentru comisioane din eGenius Platform vă permite să aplicați un comision pentru o tranzacție pe baza următorilor parametri:
Pentru a permite gateway-ului să calculeze un comision pentru o tranzacție, trebuie să configurați regulile pentru comisioane în Merchant Administration. Ca alternativă, puteți furniza un comision pre-calculat pentru comandă, dacă efectuați integrarea folosind API/Batch.
Gateway-ul acceptă comisioanele pentru tranzacțiile care utilizează următoarele metode de integrare:
Puteți aplica un comision pentru o comandă utilizând una dintre următoarele opțiuni:
Pentru a permite gateway-ului să calculeze un comision, introduceți următorul câmp într-un Authorize
/Pay
sau o solicitare Update Session
:
order.netAmount
: Aceasta este suma de plată pentru comandă înainte de aplicarea comisionului.order.amount
în cadrul solicitării. Consultați secțiunea Întrebări frecvente de mai jos.Puteți trimite o solicitare Retrieve Transaction
/Retrieve Order
pentru a apela următoarele detalii privind comisionul:
order.surchargeAmount
: Comisionul calculat de gateway, bazat pe regulile dvs. pentru comisioane.order.amount
: Valoarea totală a comenzii, inclusiv valoarea comisionului. Payment Options Inquiry
pentru a solicita valoarea calculată a comisionului completând câmpurile: session.id
, order.netAmount
, order.currency
, gatewayEntryPoint
și sourceOfFunds.provided.card.prefix
.Completați următoarele câmpuri într-un Authorize
/Pay
/Standalone Capture
sau o solicitare Update Session
:
order.amount
: Valoarea totală a comenzii, inclusiv valoarea comisionului.order.surchargeAmount
: Comisionul aplicabil comenzii, dacă există. Această valoare trebuie inclusă în valoarea totală a comenzii, specificată în câmpul order.amount
.Trimiterea unei solicitări Retrieve Transaction
/Retrieve Order
va returna detaliile comisionului așa cum au fost introduse de dvs. în solicitarea de tranzacție, plus order.netAmount
(suma netă calculată scăzând valoarea comisionului din valoarea comenzii).
Payment Options Inquiry
pentru a solicita detalii privind schema cardului/finanțarea, în vederea evaluării și aplicării comisionului corect pentru card. Pentru mai multe informații, consultați secțiunea Întrebări frecvente de mai jos.order.amount
: Valoarea totală a comenzii, inclusiv valoarea comisionului.order.merchantCharge.amount
: Valoarea comisionului suplimentar pe care îl percepeți plătitorului; în prezent, aceasta se referă doar la valoarea comisionului. order.merchantCharge.type
: Tipul de comision suplimentar pe care îl percepeți plătitorului; în prezent, aceasta se referă doar la comision. Valoarea merchantCharge.type este comision.order.netAmount
: Aceasta este suma de plată pentru comandă înainte de aplicarea comisionului.order.merchantCharge.type
: Tipul de comision suplimentar pe care îl percepeți plătitorului; în prezent, aceasta se referă doar la comision. Valoarea merchantCharge.type este comision.Referință API Authorize [REST][NVP]
Comisionul poate fi calculat de către gateway prin intermediul Hosted Checkout.
Pentru a aplica un comision unei plăți Hosted Checkout, completați următorul câmp în solicitarea Hosted Checkout (funcția Checkout.configure()
sau operațiunea Create Checkout Session
, în funcție de procesul dvs. de validare):
order.netAmount
: Suma de plată pentru comandă înainte de aplicarea comisionului. order.amount
în cadrul solicitării. Consultați secțiunea Întrebări frecvente de mai jos.Puteți trimite o solicitare Retrieve Transaction
/Retrieve Order
pentru a apela detaliile comisionului:
order.surchargeAmount
: Comisionul calculat de gateway, bazat pe regulile dvs. pentru comisioane.order.amount
: Aceasta reprezintă valoarea netă plus comisionul. Plătitorul va putea vedea comisionul aplicabil pentru cardul introdus și poate alege să continue cu valoarea totală nouă, să utilizeze un alt card sau să anuleze comanda. Confirmarea de plată prezentată plătitorului va afișa valoarea comisionului aplicat.
order.netAmount
: Suma de plată pentru comandă înainte de aplicarea comisionului. order.merchantCharge.type
: Tipul de comision suplimentar pe care îl percepeți plătitorului; în prezent, aceasta se referă doar la comision. Valoarea merchantCharge.type este comision. order.amount
în cadrul solicitării. Consultați secțiunea Întrebări frecvente de mai jos.Puteți trimite o solicitare Retrieve Transaction
/Retrieve Order
pentru a apela detaliile comisionului:
order.merchantCharge.amount
: Valoarea comisionului suplimentar pe care îl percepeți plătitorului; în prezent, aceasta se referă doar la valoarea comisionului.order.amount
: Aceasta reprezintă valoarea netă plus comisionul. Plătitorul va putea vedea comisionul aplicabil pentru cardul introdus și poate alege să continue cu valoarea totală nouă, să utilizeze un alt card sau să anuleze comanda. Confirmarea de plată prezentată plătitorului va afișa valoarea comisionului aplicat.
order.netAmount
, cât și câmpul order.amount
?Completarea câmpurilor order.netAmount
și order.amount
fără order.surchargeAmount
va returna o eroare, deoarece gateway-ul nu va avea suficiente informații pentru a calcula comisionul. Gateway-ul necesită completarea câmpului order.netAmount
SAU a câmpului order.amount
.
În cazul în care completați toate câmpurile, gateway-ul nu va calcula comisionul, ci va utiliza valoarea comisionului introdusă de dvs.
Da; pentru a renunța la comisionare,
pentru Direct API din WSAPI versiunile 50 – 66,
pentru Direct API din WSAPI versiunea 67 și versiunile ulterioare,
pentru Hosted Checkout din WSAPI versiunile 50 – 70,
pentru Hosted Checkout din WSAPI versiunea 71 și versiunile ulterioare,
Da. Deoarece comisionul este inclus în câmpul order.amount
, iar aceasta este suma care va fi rambursată plătitorului, valoarea comisionului va fi rambursată, la rândul ei. În cazul rambursărilor parțiale, comisionul va fi rambursat în mod proporțional.
Da, gateway-ul va include comisionul aplicabil în valoarea comenzii, care va fi returnată ca paymentTypes.card.currencyConversion.payerAmount
în moneda de facturare a plătitorului și în câmpul order.amount
în moneda dvs. preferată (în răspunsul la operațiunea Payment Options Inquiry
).
Puteți completa câmpul sourceOfFunds.provided.card.prefix
în solicitarea Payment Options Inquiry
pentru a apela următoarele detalii privind schema/finanțarea utilizată de card pentru plată, ceea ce poate facilita deciziile referitoare la comision:
paymentTypes.card.scheme
: Organizația care deține un tip de card și definește regulamentele de operare pentru utilizarea sa.paymentTypes.card.brand
: Tipul cardului, utilizat pentru a descrie cardul, recunoscut și acceptat la nivel mondial. Pentru multe dintre tipurile principale de carduri, acesta va fi același cu numele schemei. În unele piețe, un card poate fi, de asemenea, co-denumit cu un brand local, recunoscut și acceptat în țara/regiunea de origine (consultați Tipul local).paymentTypes.card.localBrand
: Tipul cardului, utilizat pentru a descrie cardul, recunoscut și acceptat în țara/regiunea de origine. Cardul poate fi, de asemenea, co-denumit cu un brand, recunoscut și acceptat global.paymentTypes.card.fundingMethod
: Metoda utilizată de plătitor pentru furnizarea de fonduri pentru plată.Puteți utiliza aceste detalii pentru a calcula un comision în funcție de cardul prezentat de către plătitor.
Copyright © 2023 UniCredit Bank