- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Implementarea unei integrări pentru plată prin browser
- Testarea unei integrări pentru plată prin browser
Testarea unei integrări pentru plată prin browser
După ce ați configurat contul dvs. pentru furnizorul de site web de plată și ați construit integrarea dvs., trebuie să testați integrarea utilizând profilul comerciant de testare (ID-ul dvs. comerciant la care este adăugat prefixul „TEST”). Mastercard Gateway furnizează un simulator pentru a simula site-ul web al furnizorului metodei de plată.
Testarea apelului Initiate Browser Payment
Puteți utiliza câmpul order.reference la realizarea unei solicitări Initiate Browser Payment pentru a declanșa diferite valori pentru response.gatewayCode.
Pentru o tranzacție Void, trebuie să utilizați câmpul
transaction.reference.Dacă trimiteți „.FAIL<code>” în order.reference, se vor returna următoarele:
response.gatewayCode=<code> dacă <code> este o valoare validă pentruresponse.gatewayCode.response.gatewayCode=UNKNOWNdacă <code> nu este o valoare validă pentruresponse.gatewayCode.
Pentru alte plăți prin browser (Alipay, Boleto Bancário, Bancontact, Giropay, GrabPay, iDEAL, Klarna Financing, Klarna Pay Later, Klarna Pay Now, Multibanco, OXXO, POLi, SEPA, Sofortbanking, WeChat Pay)
Puteți utiliza următoarele valori (FĂRĂ prefixul „.FAIL”) în câmpul order.reference atunci când trimiteți o solicitare Initiate Browser Payment pentru a declanșa diferite valori pentru response.gatewayCode.
| order.reference | response.gatewayCode | Comportament |
|---|---|---|
| TEST-SUCCEED | APPROVED | Tranzacția va avea succes imediat. |
| TEST-FAIL-NOTFOUND | DECLINED | Tranzacția va fi respinsă imediat. |
| TEST-FAIL-DECLINE | DECLINED | Tranzacția va fi respinsă imediat. |
| TEST-PENDING | SUBMITTED | Tranzacția va rămâne în așteptare pe perioadă nedeterminată. |
| TEST-FAIL-THEN-SUCCESS | SUBMITTED, apoi DECLINED, apoi APPROVED |
După 30 s, simulatorul va trimite o notificare și va marca tranzacția ca eșuată. După încă 60 s, simulatorul va trimite o altă notificare și va marca tranzacția ca reușită. |
| TEST-FAIL-INIT | SUBMITTED, apoi DECLINED |
După 30 s, simulatorul va trimite o notificare și va marca tranzacția ca eșuată. |
| TEST-SUCCESS-INIT | SUBMITTED, apoi APPROVED |
După 30 s, simulatorul va trimite o notificare și va marca tranzacția ca reușită. |
| TEST-TIMEOUT-THEN-SUCCESS | SUBMITTED, apoi ACQUIRER_SYSTEM_ERROR, apoi APPROVED |
După 30 s, simulatorul va trimite o notificare și va marca tranzacția ca având timpul alocat expirat. După încă 60 s, simulatorul va trimite o notificare și va marca tranzacția ca reușită. |
| TEST-QUICK-TIMEOUT-THEN-SUCCESS | SUBMITTED, apoi ACQUIRER_SYSTEM_ERROR, apoi APPROVED |
După 5 s, simulatorul va trimite o notificare și va marca tranzacția ca având timpul alocat expirat. După încă 5 s, simulatorul va trimite o notificare și va marca tranzacția ca reușită. |
| TEST-FAIL-TIMEOUT | SUBMITTED, apoi ACQUIRER_SYSTEM_ERROR |
După 30 s, simulatorul va trimite o notificare și va marca tranzacția ca având timpul alocat expirat. |
| TEST-TIMEOUT | TIMED_OUT | Simulatorul imită un scenariu de expirare a timpului alocat. Tranzacția eșuează după un interval de 31 de secunde. |
| TEST-NO-RESPONSE | UNSPECIFIED_FAILURE | Simulatorul imită un scenariu în care tranzacția nu poate fi procesată. |
Simularea rezultatelor de la un furnizor de site-uri de plată
Simulatorul de plată browser:
- Afișează un branding de bază al furnizorului de site web de plată.
- Este disponibil numai în engleză.
Pentru plățile PayPal
După integrare, ID-ul de sandbox PayPal este setat la o valoare fictivă pentru a vă permite să vă testați integrarea cu profilul dvs. de testare. Odată ce permisiunea terță este acordată, valoarea fictivă va fi înlocuită cu ID-ul real de cont PayPal.
- Sunt afișate detaliile de plată furnizate în solicitarea Initiate Browser Payment.
- Trebuie să selectați un rezultat de plată PayPal:
SUCCESSPENDINGCANCELUNKNOWNERRORTIMED_OUT- Pentru rezultate în așteptare puteți simula primirea unei notificări prin setarea întârzierii înaintea primirii notificării și a rezultatului dorit al notificării.
- După ce faceți clic pe "Plătiți acum" sau "Continuare", browserul este redirecționat înapoi la adresa URL furnizată în solicitarea Initiate Browser Payment.
- Utilizați următoarele valori în câmpul
order.referencesautransaction.referencela realizarea unei solicitări Initiate Browser Payment pentru a declanșa diferite valori pentruresponse.gatewayCode.Order.Reference sau transaction.reference response.gatewayCode Stare comandă Comportament PP.400.BADREQUEST DECLINED FAILED Tranzacția va fi respinsă imediat. PP.PENDING.AUTHORIZATION APPROVED CAPTURED Tranzacția va avea succes imediat. PP.PENDING.NONE PENDING CAPTURED Tranzacția va rămâne în așteptare pe perioadă nedeterminată. PPP.400.CAPTURE_AMOUNT_LIMIT_EXCEEDED DECLINED FAILED Tranzacția va fi respinsă imediat. PP.400.TIMEOUT DECLINED FAILED Simulatorul imită un scenariu de expirare a timpului alocat. Tranzacția eșuează imediat. PP.400.INVALID_REQUEST DECLINED FAILED Tranzacția va fi respinsă imediat. PP.400.INSUFFICIENT_FUNDS INSUFFICIENT_FUNDS FAILED Simulatorul imită un scenariu de fonduri insuficiente. Tranzacția eșuează imediat. PP.400.ORDER_VOIDED DECLINED FAILED Tranzacția va fi respinsă imediat.
Dacă vă integrați cu PayPal pentru prima dată, atunci trebuie să trimiteți următoarele valori ca parte a câmpului order.reference în timp ce vă testați integrarea
Utilizați următoarele valori în câmpul order.reference când trimiteți o solicitare Initiate Browser Payment pentru a declanșa diferite valori pentru response.gatewayCode.
| Order.Reference | response.gatewayCode | Stare comandă | Comportament |
|---|---|---|---|
| A_M | DECLINED | FAILED | Tranzacția va fi respinsă imediat. |
| P_C | PENDING | CAPTURED | Tranzacția va rămâne în așteptare pe perioadă nedeterminată. |
| I_D | DECLINED | FAILED | Acest scenariu este o simulare a scenariului Eșec finanțare. Pentru mai multe informații, consultați subiectul Gestionarea eșecurilor de finanțare. |
Pentru plățile UnionPay SecurePay
- Sunt afișate detaliile de plată furnizate în solicitarea Initiate Browser Payment.
- Trebuie să selectați un număr de card pentru a declanșa un rezultat de plată UnionPay SecurePay:
Numărul cardului de testare Cod gateway de răspuns de tranzacție 2223000000000007APPROVED 4005550000000019ACQUIRER_SYSTEM_ERROR 4508750015741019UNKNOWN 6011000991300009NOT_SUPPORTED 5149612222222229DECLINED 4012000033330026TIMED_OUT - După ce faceți clic pe "Continuare", browserul este redirecționat înapoi la adresa URL furnizată în solicitarea Initiate Browser Payment.
Pentru Alte plăți prin browser (Alipay, Boleto Bancário, Bancontact, Giropay, GrabPay, iDEAL, Klarna Financing, Klarna Pay Later, Klarna Pay Now, Multibanco, OXXO, POLi, SEPA, Sofortbanking, WeChat Pay)
- Sunt afișate detaliile de plată furnizate în solicitarea Initiate Browser Payment.
- Trebuie să selectați un rezultat de plată:
SUCCESSDECLINEBAD_REDIRECT_CHECKSUM(nu este recomandat pentru testare)
- Pentru rezultate în așteptare puteți simula primirea unei notificări prin setarea întârzierii înaintea primirii notificării și a rezultatului dorit al notificării.
- Furnizorul serviciului de plăți prin browser va returna o adresă URL de redirecționare, care vă va fi transmisă.
- Dvs. trebuie să redirecționați apoi plătitorul către pagina de plată prin browser, folosind adresa URL furnizată.
- După completarea detaliilor de plată, furnizorul serviciului de plăți prin browser va procesa solicitarea de tranzacție, iar Mastercard Gateway va redirecționa plătitorul înapoi pe site-ul dvs.
Testarea regulilor de filtrare a tranzacțiilor pentru intervalul de adrese IP
Dacă ați configurat reguli de Filtrare a tranzacțiilor după intervalul de adrese IP, puteți simula respingerea unei adrese IP interzise prin următoarea configurație:
- Configurați un interval de adrese IP care vor fi respinse în regulile pentru intervalul de adrese IP din Merchant Administration.
- Introduceți o adresă IP din intervalul respectiv în câmpul
order.referenceatunci când trimiteți o solicitareInitiate Browser Payment.- Pentru plăți prin browser, Alipay, Boleto Bancário, Bancontact, Giropay, GrabPay, iDEAL, Klarna Financing, Klarna Pay Later, Klarna Pay Now,, OXXO, POLi, SEPA, Sofortbanking, WeChat Pay, valoarea trebuie transmisă în formatul „
TEST_IP_ADDRESS<nnn.nnn.nnn.nnn>”.Acest test nu este aplicabil pentru metoda de plată prin browser Multibanco. Aceasta deoarece browserul plătitorului nu este redirecționat înapoi către site-ul web Multibanco și, prin urmare, gateway-ul nu poate obține adresa IP a plătitorului. - Pentru alte plăți prin browser, valoarea trebuie trimisă în formatul „
.TEST_IP_ADDRESS<nnn.nnn.nnn.nnn>”.
<nnn.nnn.nnn.nnn> reprezintă un format valid IPv4, care poate conține între 7 și 15 caractere. - Pentru plăți prin browser, Alipay, Boleto Bancário, Bancontact, Giropay, GrabPay, iDEAL, Klarna Financing, Klarna Pay Later, Klarna Pay Now,, OXXO, POLi, SEPA, Sofortbanking, WeChat Pay, valoarea trebuie transmisă în formatul „
Dacă adresa IP determină respingerea tranzacției, risk.response.gatewayCode va fi returnat ca „REJECTED” în operațiunea Retrieve Transaction.
Nu există teste speciale pentru simularea respingerii țărilor aflate pe o listă neagră în cadrul regulilor de filtrare a tranzacțiilor pe baza țării IP-ului, însă puteți simula acest scenariu adăugând toate țările pe lista de respingere.