Personalizarea experienței de plată
Dacă utilizați Hosted Checkout, puteți personaliza afișarea informațiilor pe Hosted Payment Page în ceea ce privește afacerea dvs. și interacțiunea cu plătitorul. Personalizările sunt definite în operațiunea INITIATE CHECKOUT.
Puteți personaliza experiența de plată cu următoarele opțiuni:
- Afișarea informațiilor brandului: Vă puteți afișa logo-ul și detaliile de contact utilizând câmpurile corespunzătoare din obiectul
interaction.merchant.Câmpurile furnizate în obiectulinteraction.merchantsunt afișate pe pagina de chitanță numai pentru integrările paginii de plată, nu și pentru pagina încorporată. - Gestionați afișarea adreselor de e-mail și de facturare a plătitorilor: După colectarea adreselor de facturare și de e-mail de la plătitor, le puteți afișa și controla modul în care pot fi editate setând câmpurile
interaction.displayControl.billingAddressșiinteraction.displayControl.customerEmailla una dintre următoarele valori: - HIDE: Nu afișați adresa.
- MANDATORY: Afișați elementul de adresă și faceți introducerea datelor obligatorie pentru plătitor.
- OPTIONAL: Afișați elementul de adresă, dar permiteți plătitorului să renunțe la introducerea datelor în acesta.
- READ_ONLY: Afișați adresa, dar nu permiteți plătitorului să o editeze.
- Gestionați afișarea detaliilor de expediere: După colectarea detaliilor de livrare de la plătitorul dvs., puteți să controlați afișarea acestora prin setarea câmpului
interaction.displayControl.shippingla una dintre următoarele valori: - HIDE Nu se afișează detaliile de expediere.
- READ_ONLY: Se afișează detaliile de expediere, dar nu se permite plătitorului să le editeze.
- Plătitorul nu poate edita niciunul dintre detaliile de expediere furnizate anterior.
- Funcționalitatea casetei de selectare „La fel ca la expediere” nu este disponibilă dacă nu au fost furnizate detaliile necesare de expediere.
- Gestionați limba și tema: Implicit, limba afișată pe Hosted Payment Page este stabilită de setarea din browserul plătitorului. Cu toate acestea, puteți suprascrie acest comportament specificând un identificator de limbă sau o etichetă de limbă IETF în câmpul de localizare; de exemplu, en_US, es sau fr_CA. Dacă limba pe care o specificați nu este acceptată de gateway, pagina este afișată în limba cea mai potrivită.
- ID comandă: Este obligatoriu să includeți
order.idîn solicitarea dvs. pentru a identifica cu ușurință o plată inițiată din Hosted Checkout. Puteți utiliza un identificator generat de către coșul dvs. de cumpărături sau puteți furniza propriul identificator. Totuși, asigurați-vă că acesta este unic.
Pentru mai multe informații despre câmpurile individuale, consultați INITIATE CHECKOUT.
Exemplu de solicitare de validare inițiată cu detalii personalizate
| URL | https://egenius.unicredit.ro/api/rest/version/{version}/merchant/{merchant_ID}/session |
| Metoda HTTP | POST |
{
"apiOperation": "INITIATE_CHECKOUT",
"interaction": {
"merchant": {
"name": "The Company Co",
"url": "https://www.merchant-site.com",
"logo": "https://upload.wikimedia.org/wikipedia/commons/2/21/Verlagsgruppe_Random_House_Logo_2016.png"
},
"displayControl": {
"billingAddress": "MANDATORY",
"customerEmail": "MANDATORY"
},
"timeout": 1800,
"timeoutUrl": "https://www.google.com",
"cancelUrl": "http://www.google.com",
"operation": "PURCHASE",
"style": {
"accentColor": "#30cbe3"
}
},
"billing": {
"address": {
"city": "St Louis",
"stateProvince": "MO",
"country": "USA",
"postcodeZip": "63102",
"street": "11 N 4th St",
"street2": "The Gateway Arch"
}
},
"order": {
"amount": "123.60",
"currency": "EUR",
"description": "This is the order description",
"id": "ORDER-4142773a-ac2e"
},
"customer": {
"email": "peteMorris@mail.us.com",
"firstName": "John",
"lastName": "Doe",
"mobilePhone": "+1 5557891230",
"phone": "+1 1234567890"
}
}
Întrebări frecvente
Există restricții referitoare la dimensiunea fișierului și dimensiunile siglei comerciantului afișate pe pagina de plată?
Nu există restricții privind dimensiunea fișierelor sau lățimea logoului. Înălțimea logo-ului trebuie să fie de cel puțin 144 px.
Pot utiliza orice furnizor de servicii de găzduire pentru găzduirea imaginii logoului?
Da, puteți găzdui imaginea logo-ului la orice furnizor, atâta timp cât adresa URL este securizată (HTTPS). Dacă sunteți în căutarea unei gazde care poate oferi găzduire HTTPS gratuită, consultați furnizori de găzduire securizată pentru imagini.