Implementarea unei integrări Hosted Payment Page

Această pagină documentează o caracteristică moștenită. Protocolul Hosted Payment Page a fost perimat de integrarea Hosted CheckoutJavaScript. Mai multe informații despre modul de obținere a rezultatului plății și particularizarea integrării dvs. pot fi accesate la pagina Hosted Checkout.

Modelul Hosted Payment Page vă permite să colectați detalii de plată de la plătitorul dvs. prin intermediul unei pagini web găzduită și afișată de eGenius Platform, administrând astfel securitatea și conformitatea PCI pentru dvs. Cu acest model de integrare, dvs. nu vizualizați sau manipulați niciodată detaliile de plată direct, deoarece detaliile de plată sunt colectate în pagina de plată și sunt trimise direct din browserul plătitorului către eGenius Platform.

Solicitarea unei pagini de plată

Solicitați Hosted Payment Page trimițând o solicitare HTTPS POST către eGenius Platform. Acest pas este de o importanță critică în integrarea comerciant deoarece datele din solicitarea dvs. stabilesc conținutul afișat pentru plătitor în cadrul paginii de plată.

Solicitarea HTTPS POST poate conține oricare dintre câmpurile descrise în Hosted Payment Page Referință API. Asigurați-vă că includeți toate câmpurile necesare în solicitarea dvs.

Un exemplu de cod pentru o integrare Hosted Payment Page de bază este prezentat mai jos:

<form method="post" action="https://egenius.unicredit.ro/api/page/version/36/pay">

<input type="hidden" name="merchant" value="<your_merchant_id>"/>
<input type="hidden" name="order.amount" value="100.00"/>
<input type="hidden" name="order.currency" value="USD"/>
<input type="hidden" name="order.description" value="37 Blue Widgets"/>
<input type="hidden" name="interaction.merchant.name" value="My Merchant Name"/>
<input type="hidden" name="interaction.cancelUrl" value="http://www.mymerchant.com"/>

<input type="submit" value="Checkout"/>
</form>

Direcționați interaction.cancelUrl către o adresă URL spre care doriți redirecționarea browserului plătitorului dacă acesta revocă plata. Aceasta poate fi o legătură înapoi către coșul de cumpărături al plătitorului sau pagina principală a site-ului magazinului dvs..

Este recomandat să includeți câmpul order.id în solicitarea dvs. pentru a identifica cu ușurință o plată inițiată din cadrul Hosted Payment Page. Puteți utiliza un identificator generat de către coșul dvs. de cumpărături sau puteți furniza propriul identificator; oricum, asigurați-vă că valoarea este unică. Dacă nu furnizați o valoare în câmpul order.id, eGenius Platform va genera automat o valoare pentru dvs.

Implicit, configurația dvs. comerciant stabilește funcționalitatea oferită plătitorului dvs. pe pagina de plată. De exemplu, metode de plată (carduri de credit, PayPal etc.), surse de tranzacție (Internet, call center etc.), opțiuni de plată (plăți structurate), serviciul 3D-Secure, managementul riscului etc.

Testarea integrării

Înainte de a începe lucrul în mediul real, trebuie să testați integrarea pentru a vă asigura de funcționarea corectă.