Hosted Payment Session: Referință câmpuri

Câmpurile Hosted Payment Session sunt utilizate pentru a colecta detalii referitoare la card de la plătitor - când este trimis, formularul este publicat direct în Serviciul Hosted Payment Session prin intermediul unei solicitări HTTPS POST. Aceasta este o cerință preliminară pentru realizarea tranzacțiilor de plată sau stocare într-o sesiune.

Trimiterea paginii de plată nu inițiază o tranzacție de plată.

Înainte de a trimite pagina de plată, trebuie să creați o sesiune utilizând operațiunea Create Session.

Referință API Create Session[REST][NVP]

Această operațiune returnează un identificator de sesiune, pe care dvs. trebuie să-l încorporați în adresa URL a Serviciului Hosted Payment Session când trimiteți pagina de plată.

Răspunsul la formular, împreună cu parametrii solicitării vă sunt returnați în formularul validat. Aceasta vă permite să realizați o operațiune utilizând identificatorul de sesiune în locul detaliilor cardului. Pentru mai multe informații, consultați secțiunea Realizarea unei operațiuni prin utilizarea sesiunii.

Metoda HTTPS POST
Adresă URL formular https://egenius.unicredit.ro/form/<formSessionIdentifier>
Autentificare Verificarea sesiunii utilizând identificatorul de sesiune.

Parametrii solicitării

Dacă valoarea parametrului solicitării este greșită, este returnată o eroare în valoarea câmpului (consultați secțiunea Tratarea erorilor) sau plătitorul (sau persoana care testează integrarea) este redirecționat către o pagină care prezintă detaliile erorii.
gatewayReturnURL  URL = (OBLIGATORIU)
Adresa URL către care doriți să redirecționați plătitorul după trimiterea detaliilor cardului. Dacă adresa URL lipsește sau este nevalidă, în browser va fi afișată o pagină care prezintă detaliile erorii. Acest câmp trebuie etichetat ca hidden (<input type="hidden"/>) în formularul de plată.
Existență
OBLIGATORIU
Reguli de validare
Trebuie să fie o adresă URL complet calificată cu HTTP:// sau HTTPS://, preferabil cea de a doua variantă, deoarece este recomandat ca browserul să fie returnat la o pagina securizată SSL. Aceasta va preveni apariția unei ferestre de avertizare în browser care să indice faptul că plătitorul este returnat către un site nesecurizat.
lungime minimă
8
lungime maximă
2000
gatewayCardNumber Cifre,spațiu,cratimă și caractere de mascare = (OPȚIONAL)
Numărul cardului de credit al plătitorului, așa cum este imprimat pe card.
  • Mascarea: Când este returnat în răspunsul la formular, numărul cardului va fi mascat conform setării de mascare stabilită de comerciant sau în format 6.4, oricare dintre cele două opțiuni este mai restrictivă (de ex.. 000000xxxxxx0000). Dacă plătitorul introduce orice caractere de mascare în valoarea trimisă inițial, valoarea va fi respinsă ca nevalidă.
  • Curățare: Orice spații sau cratime din cadrul valorii introduse de plătitor vor fi eliminate din răspuns.
  • Trunchiere: Dacă valoarea introdusă depășește lungimea maximă, răspunsul va fi trunchiat la lungimea maximă și în câmpul de răspuns va fi indicată o eroare.
  • Erori: Dacă valoarea câmpului este nevalidă, puteți re-afișa formularul (cu numărul de card mascat) indicând faptul că, câmpul prezintă o eroare.
  • Trimiterea din nou: Dacă formularul este trimis din nou cu valorile de răspuns și numărul de card mascat este trimis nemodificat, Hosted Payment Sessionva accepta aceasta ca numărul de card introdus inițial.
  • Caractere de mascare: Caracterul implicit de mascare este „x”. Puteți să înlocuiți caracterul de mascare cu „X” sau „*” la trimiterea din nou, și acestea vor fi recunoscute ca mascare validă.
Existență
OPȚIONAL
Valoare fixă
Reguli de validare
Datele reprezintă un șir format din caractere din intervalul 0-9 și „ ” (spațiu), „-” (cratimă).
Caracterele de mascare („x”, „X” și „*”) sunt valide numai la trimiterea din nou.
lungime minimă
1
lungime maximă
30
gatewayCardSecurityCode Cifre și caractere de mascare = (OPȚIONAL)
Codul de securitate card al plătitorului, așa cum este imprimat pe spatele sau fața cardului.
  • Mascarea: Când este returnat în răspunsul la formular, codul de securitate card va fi complet mascat (de ex. xxxx). Dacă plătitorul introduce orice caractere de mascare în valoarea trimisă inițial, valoarea va fi respinsă ca nevalidă.
  • Trunchiere: Dacă valoarea introdusă depășește lungimea maximă, răspunsul va fi trunchiat la lungimea maximă și în câmpul de răspuns va fi indicată o eroare.
  • Erori: Dacă valoarea câmpului este nevalidă, puteți re-afișa formularul (cu codul de securitate card mascat) indicând faptul că, câmpul prezintă o eroare.
  • Trimiterea din nou: Dacă formularul este trimis din nou cu valorile de răspuns și CSC mascat este trimis nemodificat, Hosted Payment Session va accepta aceasta ca CSC introdus inițial.
  • Caractere de mascare: Caracterul implicit de mascare este „x”. Puteți să înlocuiți caracterul de mascare cu „X” sau „*” la trimiterea din nou, și acestea vor fi recunoscute ca mascare validă. Orice caractere de mascare vor fi considerate nevalide în cadrul trimiterii inițiale.
Existență
OPȚIONAL
Valoare fixă
Reguli de validare
Datele reprezintă un șir format din caractere din intervalul 0-9.
Caracterele de mascare („x”, „X” și „*”) sunt valide numai la trimiterea din nou.
lungime minimă
0
lungime maximă
10
gatewayCardExpiryDateMonth  Cifre = (OBLIGATORIU)
Luna de expirare, așa cum este imprimată pe card. Lunile sunt numerotate de la IAN=1, până la Decembrie=12. Dacă valoarea câmpului este nevalidă, puteți re-afișa formularul indicând faptul că acest câmp prezintă o eroare.
Existență
OBLIGATORIU
Valoare fixă
Reguli de validare
Datele sunt un număr între 1 și 12 reprezentat ca șir de caractere.
lungime minimă
1
lungime maximă
2
gatewayCardExpiryDateYear  Cifre = (OBLIGATORIU)
An de expirare, așa cum este imprimat pe card. Anul reprezentat este 2000 plus această valoare. Dacă valoarea câmpului este nevalidă, puteți re-afișa formularul indicând faptul că acest câmp prezintă o eroare.
Existență
OBLIGATORIU
Valoare fixă
Reguli de validare
Datele reprezintă un șir format din caractere din intervalul 0-9. Valoarea trebuie să fie între 2000 și 2099 sau 00 și 99.
lungime minimă
2
lungime maximă
4
gatewayRedirectDisplayBackgroundColor Alfanumeric și alte caractere = (OPȚIONAL)
Culoarea de fundal a paginii afișate în browserul plătitorului înainte ca răspunsul la formular să fie publicat înapoi către integrarea comerciantului. Este recomandat ca valoarea specificată pentru culoare să se potrivească cu schema de culoare a site-ului dvs. web pentru a oferi o experiență cursivă plătitorului. Acest câmp trebuie etichetat ca ascuns (<input type="hidden"/>) în formularul de plată.
Existență
OPȚIONAL
Reguli de validare
Următoarele reprezentări CSS sunt considerate valide.
Valorile nevalide vor fi eliminate din valorile introduse și în locul lor va fi utilizată valoarea implicită.
  • Hexazecimal: Formatul unei valori RGB în notație hexazecimală este un caracter „#” urmat imediat fie de trei, fie de șase caractere hexazecimale. De ex. #F00, #FF0000
  • Denumiri culori: Denumiri de culori precum „red”, „white” etc.
  • Valoare RGB: „rgb” urmat de 3 valori numerica în paranteze de ex. „rgb(255,0,0)”
valoare implicită
#000000 (white) (alb)
lungime minimă
3
lungime maximă
30
gatewayRedirectDisplayTitle Alfanumeric = (OPȚIONAL)
Titlul paginii afișate în browserul plătitorului înainte ca răspunsul la formular să fie publicat înapoi către integrarea comerciantului. Este recomandat ca titlul pe care îl specificați să ofere o senzație de continuitate plătitorului, astfel îmbunătățind experiența procesului de achiziționare. Acest câmp trebuie etichetat ca ascuns (<input type="hidden"/>) în formularul de plată.
Existență
OPȚIONAL
Reguli de validare
Text
valoare implicită
Detalii de plată trimise
lungime minimă
0
lungime maximă
255
gatewayRedirectDisplayContinueButtonText Alfanumeric = (OPȚIONAL)
Titlul butonului care va fi redat în browserul plătitorului dacă opțiunea JavaScript este dezactivată. Este recomandat ca textul pe care îl specificați pentru buton să se încadreze bine în experiența procesului de achiziționare pentru plătitor. Apăsarea butonului va publica răspunsul la formular înapoi către integrarea comerciantului. Acest câmp trebuie etichetat ca ascuns (<input type="hidden"/>) în formularul de plată.
Existență
OPȚIONAL
Reguli de validare
Text
valoare implicită
Apăsați aici pentru a continua
lungime minimă
0
lungime maximă
255

Parametrii răspunsului

Toți parametrii remiși în solicitare vor fi returnați în răspuns. În plus, vor fi returnați următorii parametri.

Câmpurile gatewayCardBrand, gatewayCardLocalBrand și gatewayCardFundingMethod sunt returnate numai dacă utilizați solicitarea Create Session în versiunea 15+.
gatewayFormResponse  Enumerare = (Returnat întotdeauna)
Indică rezultatul general al trimiterii formularului.
Existență
Returnat întotdeauna
Reguli de validare
Un cod de răspuns general în format R~D, unde R este un cod format dintr-un singur caracter care indică rezultatul și D este descrierea în limba engleză. Această valoare trebuie verificată înainte de a procesa celelalte câmpuri din răspunsul la formular.
Valoarea trebuie să aparțină următoarei liste. Valorile sunt sensibile la litere mari și mici.
0~OK
Indică faptul că formularul este valid — returnat când nu sunt depistate erori ale formularului.
2~Session identifier invalid or closed for updates
Indică o sesiune nevalidă — returnat când sesiunea lipsește, a expirat, este închisă sau nevalidă.
3~Field Errors
Indică erori în cadrul câmpurilor — returnat dacă validarea oricăruia dintre câmpurile formularului eșuează.
4~System Error
Indică o eroare de sistem — returnat dacă este întâmpinată o eroare a Gateway-ului de plăți sau o altă eroare.
gatewayCardScheme  Enumerare =
Schema cardului determinată pentru cardul furnizat.
Existență
Returnat întotdeauna
Reguli de validare
Valoarea trebuie să aparțină următoarei liste. Valorile sunt sensibile la litere mari și mici.
AMEX
American Express
DINERS_CLUB
Diners Club
DISCOVER
Discover
JCB
JCB (Japan Credit Bureau)
MASTERCARD
Mastercard
UATP
UATP (Universal Air Travel Plan)
VISA
Visa
OTHER (ALTELE)
Schema cardului utilizat în tranzacție nu a putut fi identificată.
gatewayCardBrand  Enumerare =