- Ghid de integrare
- Caracteristici acceptate
- Comisionarea
Comisionarea
Un comision este o sumă suplimentară percepută de comerciant pentru a acoperi costurile acceptării plăților cu cardul. Funcționalitatea pentru comisioane din ARC Pay Gateway vă permite să aplicați un comision pentru o tranzacție pe baza următorilor parametri:
- punctul de intrare în gateway, de exemplu Checkout, webServices Integration
- metoda de plată; de exemplu, Mastercard, Visa, American Express
- metoda de finanțare; de exemplu, credit, debit
- moneda
- sectorul de activitate
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 webServices Integration/Batch Integration.
Cerințe preliminare
- Trebuie să aveți activată opțiunea de comision în profilul dvs. de comerciant din ARC Pay Gateway.
- Pentru a permite gateway-ului să calculeze comisioanele, trebuie să configurați regulile pentru comisioane în Merchant Administration.
Integrarea pentru utilizarea comisioanelor
Gateway-ul acceptă comisioanele pentru tranzacțiile care utilizează următoarele metode de integrare:
Integrarea prin webServices Integration/Batch Integration
Puteți aplica un comision pentru o comandă utilizând una dintre următoarele opțiuni:
- comision calculat de gateway
Pentru a permite gateway-ului să calculeze un comision, introduceți următorul câmp într-un
Authorize/Paysau o solicitareUpdate Session:order.netAmount: Aceasta este suma de plată pentru comandă înainte de aplicarea comisionului.
Nu furnizați câmpulorder.amountîn cadrul solicitării. Consultați secțiunea Întrebări frecvente de mai jos.Puteți trimite o solicitare
Retrieve Transaction/Retrieve Orderpentru 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.
Puteți utiliza, de asemenea, operațiuneaPayment Options Inquirypentru a solicita valoarea calculată a comisionului completând câmpurile:session.id,order.netAmount,order.currency,gatewayEntryPointșisourceOfFunds.provided.card.prefix. - comision calculat de comerciant
Completați următoarele câmpuri într-un
Authorize/Pay/Standalone Capturesau o solicitareUpdate 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âmpulorder.amount.
Trimiterea unei solicitări
Retrieve Transaction/Retrieve Orderva returna detaliile comisionului așa cum au fost introduse de dvs. în solicitarea de tranzacție, plusorder.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.- comision calculat de comerciant
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.
- Comision calculat de gateway
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]
Referință API Retrieve Transaction [REST][NVP]
Referință API Payment Options Inquiry [REST][NVP]
Integrarea prin Checkout
Comisionul poate fi calculat de către gateway prin intermediul Checkout.
Pentru a aplica un comision unei plăți Checkout, completați următorul câmp în solicitarea 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.
Întrebări frecvente
Gateway-ul va calcula un comision dacă solicitarea mea include atât câmpul 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.
Pot alege să nu comisionez plățile cu cardul atunci când trimit o tranzacție?
Da; pentru a renunța la comisionare,
- furnizați câmpul order.amount în solicitarea de tranzacție, pentru a indica valoarea totală a comenzii.
pentru Direct API din WSAPI versiunile 50 – 66,
- dacă comisionul este calculat de comerciant, nu introduceți nicio valoare în câmpurile order.netAmount și order.surchargeAmount.
- dacă comisionul este calculat de către gateway, nu introduceți nicio valoare în câmpul order.netAmount.
pentru Direct API din WSAPI versiunea 67 și versiunile ulterioare,
- dacă comisionul este calculat de comerciant, nu introduceți nicio valoare în câmpurile order.netAmount, order.merchantCharge.amount și order.merchantCharge.type pentru comision.
- dacă comisionul este calculat de gateway, nu introduceți nicio valoare în câmpurile order.netAmount și order.merchantCharge.Type pentru comision.
pentru Hosted Checkout din WSAPI versiunile 50 – 70,
- comisionul este calculat întotdeauna de gateway, nu introduceți nicio valoare în câmpul order.netAmount.
pentru Hosted Checkout din WSAPI versiunea 71 și versiunile ulterioare,
- comisionul este calculat întotdeauna de gateway, nu introduceți nicio valoare în câmpul order.netAmount sau order.merchantCharge.type pentru comision.
Dacă plătitorul solicită o rambursare, comisionul va fi rambursat?
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.
Dacă am conversia valutară dinamică (DCC) activată, gateway-ul va calcula comisionul atât în moneda de facturare a plătitorului, cât și în moneda mea preferată?
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).
Pot apela datele de identificare a tipului cardului pentru a facilita calcularea comisionului unei comenzi?
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.