Pași pentru integrare
Pentru a implementa soluția de bază Hosted Session în sistemul dvs., urmați instrucțiunile de mai jos.
Cerințe preliminare
Înainte de a implementa o soluție Hosted Session, verificați Your payment service provider pentru a vă asigura că îndepliniți următoarele cerințe preliminare:
- Asigurați-vă că aveți un cont de comerciant și că profilul dvs. de comerciant este activat pentru serviciul Hosted Session.
- Asigurați-vă că utilizați API v18 sau o versiune ulterioară.
- Selectați și configurați metoda dvs. de autentificare API.
Implementarea unei integrări Hosted Session
Soluția Hosted Session funcționează prin operațiuni API (solicitări și răspunsuri), care sunt utilizate, de exemplu, pentru a gestiona sesiunile și a iniția sau a prelua informații despre diferite tranzacții de plată. De asemenea, aveți nevoie de biblioteca Session JavaScript pentru a gestiona câmpurile formularului de plată găzduit din aplicația sau pagina dvs. web, atunci când este necesară participarea plătitorului pentru a aduna detaliile de plată pentru o tranzacție. Pentru mai multe informații despre gestionarea sesiunilor, consultați Noțiunile de bază ale sesiunilor.
Puteți utiliza toate operațiunile API disponibile pentru API-urile serverului REST. Cu toate acestea, nu aveți nevoie de operațiunile API legate de Hosted Checkout, deoarece acestea sunt necesare pentru metoda de integrare aferentă.
Când este necesară participarea plătitorului, fiecare sarcină pe care o efectuați cu metoda de integrare Hosted Session constă în următorii pași:
- Pe serverul dvs., creați o nouă sesiune ca container pentru toate datele sensibile cerute de tranzacție.
- În aplicația sau site-ul dvs., atașați câmpurile formularului găzduit la pagina dvs. de plată și permiteți plătitorului să le completeze.
- În aplicația sau pe site-ul dvs., actualizați sesiunea cu datele furnizate.
- Pe serverul dvs., trimiteți o solicitare de tranzacție de plată către gateway, cu referire la sesiune.
- Pe serverul dvs., preluați datele de răspuns din tranzacția de plată. Interpretați răspunsul și afișați rezultatul tranzacției plătitorului în aplicația sau site-ul dvs. web.
Pentru informații despre gestionarea pașilor 1-4 de mai sus, consultați Efectuarea unei plăți. Pentru informații despre gestionarea rezultatului tranzacției, consultați Interpretarea răspunsului.
Pentru o colecție de exemple de solicitări care acoperă solicitările comune de operațiuni de tranzacție, descărcați colecția Postman.
După finalizarea integrării, sunteți capabil să gestionați solicitările și răspunsurile de bază:
- Luați în considerare ciclurile de viață ale plăților și nevoile pentru orice operațiuni ulterioare după finalizarea tranzacției de plată de bază.
- Determinați eventualele personalizări pe care trebuie să le faceți pe baza metodelor de plată pe care doriți să le susțineți.
- Luați în considerare ce fel de securitate sau alte funcții suplimentare doriți să oferiți sau să utilizați în integrare.
- Testați întreaga soluție.