Depanare și Întrebări frecvente

Această secțiune conține sugestii și sluții pentru problemele cu care vă puteți confrunta în legătură cu integrarea dvs.

Cât timp va fi validă o autorizare pentru contul unui plătitor?

Aceasta depinde de instituția financiară care a emis cardul plătitorului. Fiecare emitent de carduri definește o perioadă de expirare a autorizării, în care mențin fondurile blocate în contul plătitorului, în timp ce așteaptă primirea unei tranzacții de decontare. În general, este vorba de 5-8 zile de procesare, înainte ca autorizarea să fie anulată din contul plătitorului și să fie eliberat din nou accesul plătitorului la fonduri.

Cum sunt combinate în solicitări detaliile despre carduri din surse multiple (simboluri card, sesiuni de plată)?
Cum analizez erorile de validare dacă doresc să afișez mesaje prietenoase pentru plătitori?

Puteți utiliza următoarele câmpuri pentru a intercepta erorile de validare:


Câmpul error.explanation [REST][NVP] va conține un text de descriere a erorii în limbaj uman care oferă informații suplimentare referitoare la eroare, cum ar fi lungimea minimă acceptată etc. Nu analizați aceste informații, deoarece formatul acestui text nu poate fi garantat.

Cum sunt mapate codurile de răspuns Payment Client și Virtual Payment Client în API?

Integrările cu Payment Client și Virtual Payment Client returnează coduri de răspuns diferite de enumerările returnate pentru API. Tabelele de mai jos prezintă maparea între cele două tipuri de răspunsuri returnate de eGenius Platform.

Coduri de răspuns de tranzacție
Payment Client/Virtual Payment Client API
Cod de răspuns Descriere response.gatewayCode Descriere
0 Tranzacție realizată cu succes APPROVED Tranzacție aprobată
1 Tranzacția nu a putut fi procesată UNSPECIFIED_FAILURE Tranzacția nu a putut fi procesată
2 Tranzacție refuzată - Contactați banca emitentă DECLINED Operațiunea solicitată a eșuat. De exemplu, o plată a fost respinsă de către emitent sau autentificarea plătitorului nu a putut fi efectuată cu succes.
3 Tranzacție refuzată - Niciun răspuns din partea băncii TIMED_OUT Timpul de așteptare răspuns a expirat
4 Tranzacție refuzată - Card expirat EXPIRED_CARD Tranzacție refuzată din cauza expirării cardului
5 Tranzacție refuzată - Credit insuficient INSUFFICIENT_FUNDS Tranzacție refuzată din cauza fondurilor insuficiente
6 Tranzacție refuzată - Eroare sistem bancă ACQUIRER_SYSTEM_ERROR A apărut o eroare în sistemul achizitorului în decursul procesării tranzacției
7 Eroare de procesare server de plăți. În mod normal cauzată de date de intrare nevalide, cum ar fi un număr de card de credit. Pot apărea, de asemenea, erori de procesare. SYSTEM_ERROR A apărut o eroare internă de sistem în decursul procesării tranzacției
8 Tranzacție refuzată - Tip de tranzacție neacceptat NOT_SUPPORTED Tip de tranzacție neacceptat
9 Banca a refuzat tranzacția (Nu contactați Banca) DECLINED_DO_NOT_CONTACT Tranzacție refuzată - nu contactați emitentul
A Tranzacție abandonată ABORTED Tranzacție abandonată de posesorul de card
B Tranzacție blocată - Reveniți când:
-Nivelul de securitate verificare are o valoare de „7”,
- Comerciantul are activată blocarea 3D-Secure,
- evaluarea generală de risc returnează „Respingere” sau „Respingere din sistem”
BLOCKED Tranzacție blocată din cauza Riscului sau regulilor de blocare 3D-Secure
C Tranzacție revocată CANCELLED Tranzacție revocată de posesorul de card
D Tranzacție cu perioadă de grație DEFERRED_TRANSACTION_RECEIVED Tranzacție cu perioadă de grație recepționată și în așteptarea procesării
E Tranzacție refuzată - Consultați emitentul cardului REFERRED Tranzacție refuzată - consultați emitentul
F Autentificare 3D-Secure eșuată AUTHENTICATION_FAILED Autentificare 3D-Secure eșuată
I Cod de securitate card eșuat INVALID_CSC Cod de securitate card nevalid
L Tranzacție de achiziționare blocată. Această stare indică faptul că există o altă tranzacție care este în desfășurare cu același număr de tranzacție de achiziționare. LOCK_FAILURE Comandă blocată - o altă tranzacție este în desfășurare pentru această comandă
M Tranzacție trimisă (tranzacția a fost direcționată către achizitor, dar Serverul de plăți nu a primit-o încă pentru a finaliza tranzacția) SUBMITTED Tranzacție trimisă - nu a fost încă primit răspunsul
N Posesorul de card nu este înscris la 3D-Secure (numai autentificare). NOT_ENROLLED_3D_SECURE Posesor card nu este înscris la 3D-Secure
P Tranzacția este în așteptare PENDING Tranzacția este în așteptare
R Limitele de încercare din nou au fost depășite, Tranzacția nu a fost procesată EXCEEDED_RETRY_LIMIT Limită de încercare din nou a tranzacției depășită
S Tranzacție refuzată - Lot dublat DUPLICATE_BATCH Tranzacție refuzată din cauza faptului că lotul este dublat
T Verificare adresă eșuată DECLINED_AVS Tranzacție refuzată din cauza verificării adresei
U Cod de securitate card eșuat DECLINED_CSC Tranzacție refuzată din cauza codului de securitate card
V Verificare adresă și Cod de securitate card eșuate DECLINED_AVS_CSC Tranzacție refuzată din cauza verificării adresei și codului de securitate card
M Tranzacție refuzată - Nu este acceptată plata structurată. DECLINED_PAYMENT_PLAN Tranzacție refuzată din cauza plății structurate
X Aprobată, în așteptare decontare - Aprobată de un sistem de decontare în lot, dar încă în așteptarea detaliilor suplimentare de la achizitor. APPROVED_PENDING_SETTLEMENT Tranzacție aprobată - în așteptarea decontării lotului
? Răspuns necunoscut UNKNOWN Răspuns necunoscut
Coduri de răspuns Serviciu verificare adresă (AVS)
Payment Client/Virtual Payment Client API
Cod de răspuns Descriere response.cardholderVerification.avs.gatewayCode Descriere
X Adresă și cod poștal/cod zip de 9 cifre – corecte ADDRESS_ZIP_MATCH Adresă stradă și cod zip/cod poștal corecte
Y Adresă și cod poștal/cod zip de 5 cifre – corecte
D Adresă stradă și cod poștal corecte pentru o tranzacție internațională.
M Adresă stradă și cod poștal corecte pentru o tranzacție internațională.
F Adresă stradă și cod poștal corecte. Aplicabil doar pentru Marea Britanie.
W Cod ZIP de 9 cifre/cod poștal corecte, Adresă incorectă ZIP_MATCH Cod ZIP/cod poștal corect. Adresă stradă incorectă
P Cod poștal corect pentru tranzacție internațională, dar adresă stradă neverificată datorită formatelor incompatibile.
Z Cod ZIP de 5 cifre/cod poștal corecte, Adresă incorectă
A Numai adresă corectă ADDRESS_MATCH Adresă stradă corectă
B Adresă stradă corectă pentru o tranzacție internațională. Cod poștal neverificat datorită formatelor incompatibile.
S Serviciu neacceptat în prezent. SERVICE_NOT_SUPPORTED Serviciu neacceptat în prezent de către achizitor sau comerciant
G Tranzacție internațională, informații adresă indisponibile. NOT_VERIFIED AVS nu a putut fi verificat pentru o tranzacție internațională
C Adresă stradă și cod poștal neverificate pentru o tranzacție internațională datorită formatelor incompatibile.
I Numai Visa. Informații adresă neverificate pentru tranzacție internațională.
R Sistemul emitentului este indisponibil. Încercați din nou. SERVICE_NOT_AVAILABLE_RETRY Sistemul emitentului este indisponibil. Se poate încerca din nou
U Adresă indisponibilă, nu există date de la Emitent. NOT_AVAILABLE Nu sunt disponibile date de la emitent sau datele AVS nu sunt acceptate pentru tranzacție
E Nu este comandă prin poștă/comandă telefonică.
N Adresă și cod ZIP/cod poștal incorecte NO_MATCH Niciun rezultat
0 (zero) Nu a fost solicitat AVS. (Utilizat de VisaII.) NOT_REQUESTED AVS nu a fost solicitat
K Numai nume posesor card corect. NAME_MATCH Nume posesor card corect
O Numele posesorului cardului și adresa se potrivesc NAME_ADDRESS_MATCH Numele posesorului cardului și adresa se potrivesc
L Numele posesorului cardului și codul poștal se potrivesc NAME_ZIP_MATCH Numele posesorului cardului și codul poștal se potrivesc
Coduri de răspuns Cod de securitate card (CSC)
Payment Client/Virtual Payment Client API
Cod de răspuns Descriere response.cardSecurityCode.gatewayCode Descriere
M CSC valid sau corect MATCHED Valid sau corect
S Comerciantul indică faptul că CSC nu este prezent pe card NOT_PRESENT Comerciantul indică faptul că CSC nu este prezent pe card
P CSC neprocesat NOT_PROCESSED Neprocesat
U Emitentul cardului nu este înregistrat/certificat NOT_SUPPPORTED Emitentul cardului nu este înregistrat/certificat
N Cod nevalid sau incorect NO_MATCH Cod nevalid sau incorect.
Dacă nu primesc niciun răspuns, pot retrimite solicitarea către eGenius Platform?

Da, puteți retrimite în siguranță o solicitare cu aceleași detalii, deoarece gateway-ul acceptă operațiunile idempotente. Operațiunile idempotente produc același rezultat atunci când sunt invocate în mod repetat. Dacă gateway-ul a primit deja solicitarea dvs., acesta va returna răspunsul original; în caz contrar, va procesa solicitarea și va returna răspunsul.

Cum pot stabili corespondența dintre solicitările către eGenius Platform și răspunsuri?

În mod normal, puteți stabili corespondența solicitărilor cu răspunsurile utilizând câmpurile order.id și transaction.id, dat fiind că acestea sunt furnizate în solicitări și returnate în răspunsuri. Dacă, însă, aplicația dvs. nu acceptă un model de integrare sincronă sau sursa și ținta unei solicitări diferă, puteți utiliza câmpul correlationId pentru a identifica solicitarea și răspunsul corespunzător. correlationId este un identificator temporar, a cărui valoare nu rămâne în gateway și este returnat așa cum este furnizat în răspunsul la solicitare. Puteți utiliza correlationId cu toate solicitările API.

De ce primesc eroarea No merchant acquirer link pentru un achizitor pentru care sunt configurat?

Contactați furnizorul de servicii de plată pentru a vă asigura că legătura dvs. de achizitor comerciant de pe gateway este configurată pentru combinațiile corespunzătoare dintre tipul de card și monedă.

Ce este Administrare cont comerciant?

Administrare cont comerciant este o interfață web care permite comercianților să își urmărească și să își gestioneze cu ușurință comenzile. Comercianții pot căuta și vedea detaliile comenzilor/tranzacțiilor, pot descărca rapoarte CSV, pot verifica rezultatele 3D-Secure, pot configura mijloace de control al riscurilor, pot crea manual comenzi, pot gestiona rambursările și multe altele. Pentru mai multe detalii, consultați Ghidul utilizatorului pentru Administrare cont comerciant.

Comercianții trebuie integrați pe gateway și să aibă un profil de comerciant configurat cu succes pentru a putea accesa Administrare cont comerciant.

Copyright © 2021 UniCredit Bank