- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Implementarea unei integrări pentru plată prin browser
- Plăți UnionPay SecurePay
UnionPay SecurePay
UnionPay International prin UnionPay Online Payment (UPOP), un sistem global de plată pentru tranzacțiile de comerț electronic, oferă UnionPay SecurePay ca serviciu care permite plătitorilor să facă achiziții online folosindu-și contul UPOP SecurePay pe site-ul web UnionPay SecurePay.
UnionPay SecurePay este o metodă de plată prin browser acceptată în Mastercard Gateway. Această pagină descrie detaliile integrării specifice UnionPay SecurePay. Este recomandat să citiți ghidul de integrare pentru plățile prin browser înainte de a crea o integrare UnionPay SecurePay.
Cerințe preliminare
Pentru a oferi UnionPay SecurePay ca metodă de plată în Mastercard Gateway:
- Trebuie să fiți înregistrat pe UPOP prin your payment service provider.
- Odată configurat cu UPOP, profilul dvs. de comerciant de pe Mastercard Gateway trebuie configurat prin your payment service provider folosind detaliile contului dvs. la UPOP.
- Paginile dvs. de validare trebuie să respecte cerințele de branding UnionPay SecurePay. Consultați Ghidul de acceptare UnionPay International pentru comercianții care desfășoară comerț electronic.
Integrarea UnionPay SecurePay
Cu integrările Hosted Checkout având versiunea 34 și versiunile ulterioare, UnionPay SecurePay este disponibil automat când your payment service provider a configurat legătura achizitor pentru UnionPay SecurePay.
interaction.timeout pentru a limita timpul disponibil plătitorului pentru a finaliza comanda, atunci când timpul rămas până la expirarea plății este mai mic de 900 de secunde, plătitorul nu va mai avea posibilitatea de a selecta UnionPay SecurePay ca metodă de plată în Hosted Checkout. Pentru detalii, consultați Plățile prin browser în integrarea Hosted Checkout.
Alegeți integrarea Direct Payment dacă doriți să oferiți metoda de plată UnionPay SecurePay pe propria dvs. pagină de validare.
Efectuați o solicitare Initiate Browser Payment unde sourceOfFunds.type = UNION_PAY. Pentru alte detalii, consultați Plățile prin browser în integrarea Direct Payment.
Interpretarea rezultatului tranzacției
Tabelul următor prezintă codurile de răspuns la tranzacții pentru scenariile posibile care pot apărea după inițierea unei plăți UnionPay SecurePay prin browser.
| Scenariu | Răspunsul la Retrieve Transaction/Retrieve Order |
|---|---|
| TRANSACTION SUCCESSFUL | |
| Plata a fost realizată cu succes. | browserPayment.interaction.status=COMPLETEDresponse.gatewayCode=APPROVED |
| TRANSACTION NOT SUCCESSFUL | |
| Plata a fost respinsă de achizitor. | browserPayment.interaction.status=COMPLETEDresponse.gatewayCode=DECLINED |
| Plata nu a avut succes, deoarece achizitorul nu a putut-o procesa. | browserPayment.interaction.status=COMPLETEDresponse.gatewayCode=ACQUIRER_SYSTEM_ERROR |
| Mastercard Gateway nu a putut iniția cu succes plata UnionPay SecurePay. | browserPayment.interaction.status=N/Aresponse.gatewayCode=SYSTEM_ERROR |
| Mastercard Gateway a primit browserul plătitorului și l-a redirecționat către UnionPay SecurePay. Nu a avut loc nicio plată în interval de 2 ore. Orice solicitări de redirecționare pentru această plată sunt respinse de către Mastercard Gateway. |
browserPayment.interaction.status=REDIRECTED_TO_PROVIDERresponse.gatewayCode=DECLINED |
| Mastercard Gateway nu a primit o redirecționare a browserului plătitorului de la comerciant în interval de 24 de ore. Nu a avut loc nicio plată și orice solicitări de redirecționare pentru această plată sunt respinse de către Mastercard Gateway. |
browserPayment.interaction.status=INITIATEDresponse.gatewayCode=TIMED_OUT |
| TRANSACTION RESULT NOT YET KNOWN (IN PROGRESS) | |
| Tranzacția a fost inițiată cu succes pe gateway. Gateway-ul nu a primit încă browserul plătitorului de la comerciant pentru redirecționarea către UnionPay SecurePay. Nu a fost realizată încă nicio plată. | browserPayment.interaction.status=INITIATEDresponse.gatewayCode=SUBMITTED |
| Gateway-ul a primit browserul plătitorului și l-a redirecționat către UnionPay SecurePay. Nu a fost realizată încă nicio plată. |
browserPayment.interaction.status=REDIRECTED_TO_PROVIDERresponse.gatewayCode=SUBMITTED |
| Gateway-ul a retrimis browserul plătitorului înapoi la comerciant. Gateway-ul încearcă în prezent să determine dacă plata a avut succes sau nu. |
browserPayment.interaction.status=RETURNED_TO_MERCHANTresponse.gatewayCode=SUBMITTED |
| Gateway-ul nu a putut determina dacă plata a avut succes sau nu. Gateway-ul poate determina starea tranzacției în viitor, caz în care o va actualiza. Puteți continua cu o solicitare Retrieve Transaction (deoarece este posibil ca gateway-ul să fi aflat rezultatul) sau puteți utiliza notificările Webhook de pe gateway (dacă v-ați abonat la acestea). |
browserPayment.interaction.status=RETURNED_TO_MERCHANTresponse.gatewayCode=UNKNOWN |
| TRANSACTION STATUS UNKNOWN | |
| Gateway-ul nu a putut determina dacă plata a avut succes sau nu. Gateway-ul nu va mai încerca să afle rezultatul. Trebuie să contactați achizitorul pentru a afla rezultatul. |
browserPayment.interaction.status=N/Aresponse.gatewayCode=UNKNOWN |
Decontări și rambursări
Puteți efectua decontări sau rambursări ulterioare pentru comenzi UnionPay SecurePay utilizând operațiuni Capture/Refund API sau prin Merchant Administration.
Invalidări
Puteți efectua tranzacții de anulare pe comenzi UnionPay SecurePay utilizând operațiunea API Void sau prin Merchant Administration. Pentru anulări, sunt acceptate numai tranzacțiile Authorize, Capture și Pay.
Testarea integrării
Mastercard Gateway furnizează un emulator UnionPay SecurePay care vă permite să vă testați integrarea UnionPay SecurePay.
Depanare și întrebări frecvente
Retrieve Transaction?Contul dvs. de comerciant UPOP poate fi configurat pentru a nu returna numărul de card. În acest caz, nu veți vedea niciun număr de card returnat în răspunsul Retrieve Transaction. Contactați your payment service provider dacă doriți să modificați această configurație la UPOP.
Dacă Mastercard Gateway nu a putut identifica schema și tipul asociate cardului plătitorului, atunci Retrieve Transaction va returna sourceOfFunds.provided.card.scheme=OTHER și sourceOfFunds.provided.card.brand=UNKNOWN.