- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Implementarea unei integrări pentru plată prin browser
- Plățile WeChat Pay
WeChat Pay
WeChat Pay este un serviciu de plăți pentru comerțul electronic utilizat în China, care permite plătitorilor să efectueze achiziții folosind transferuri directe online din conturile lor WeChat Pay. Plătitorii sunt redirecționați către contul lor WeChat Pay, pe care pot iniția o plată instantanee.
WeChat Pay este o metodă de plată prin browser acceptată în <<paymentGateway>>. Această pagină descrie detaliile integrării specifice metodei WeChat Pay. Este recomandat să citiți ghidul de integrare pentru plățile prin browser înainte de a crea o Integrarea WeChat Pay.
Plățile prin browser WeChat Pay sunt acceptate numai pentru tranzacțiile în monedele EUR, USD, GBP, CNY și CHF.
Cerințe preliminare
Pentru a oferi WeChat Pay ca metodă de plată în <<paymentGateway>>:
- Trebuie să vă înregistrați la furnizorul dvs. de servicii de plată prin browser.
- Profilul dvs. de comerciant de pe gateway trebuie configurat cu detaliile contului dvs. de la furnizorul de servicii de plată prin browser.
- Trebuie să aveți un cont bancar într-una dintre monedele acceptate, asociat contului dvs. de comerciant de la furnizorul de servicii de plată prin browser.
Rețineți că gateway-ul acceptă WeChat Pay numai pentru comercianții transfrontalieri, respectiv comercianții internaționali care intră pe piața chineză și turiștii chinezi din străinătate care doresc să plătească cu WeChat Pay. Gateway-ul nu permite procesarea nativă a monedei CNY pentru comercianții cu sediul în China.
În cazul comercianților transfrontalieri:
- Valoarea comenzii este prezentată plătitorului (de către gateway) în moneda de procesare (de exemplu, EUR).
- Plătitorul este debitat în CNY de către WeChat Pay, plătind un comision de conversie valutară.
- Suma este decontată comerciantului în EUR, de către furnizorul de servicii de plată prin browser.
Integrarea WeChat Pay
Serviciul WeChat Pay va fi disponibil în curând prin <<checkout>>. Vă rugăm să contactați your payment service provider pentru mai multe informații.
Integrarea <<directPayment>> vă permite să oferiți metoda de plată WeChat Pay pe propria dvs. pagină de validare.
În plus față de câmpurile standard obligatorii într-o solicitare de plată prin browser, trebuie să completați următoarele câmpuri în solicitarea Initiate Browser Payment:
sourceOfFunds.type=WECHAT_PAYbrowserPayment.operation=PAY(operațiunea Authorize nu este acceptată de WeChat Pay).sourceOfFunds.provided.weChatPay.accountHolder: Numele posesorului contului WeChat Pay al plătitorului.
Limba preferată
Puteți seta limba în care doriți ca serviciul WeChat Pay să afișeze paginile pentru plătitor, completând câmpul browserPayment.preferredLanguage din solicitarea Initiate Browser Payment. Limba va fi utilizată, însă, numai dacă este acceptată de WeChat Pay.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"https://<return_url>"
},
"order": {
"amount": "10.00",
"currency": "EUR"
},
"sourceOfFunds": {
"type": "WECHAT_PAY",
"provided": {
"weChatPay": {
"accountHolder": "John Smith"
}
}
}
}
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 WeChat Pay.
Răspunsul la Initiate Browser Payment |
Ce înseamnă... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Redirecționați plătitorul la adresa URL inclusă în răspuns. |
Răspunsul la Retrieve Transaction/Retrieve Order |
Ce înseamnă... |
response.gatewayCode=APPROVEDresult=SUCCESSsourceOfFunds.provided.weChatPay.accountHolder
|
Plata a fost realizată cu succes. |
response.gatewayCode=PENDINGresult=PENDING |
<<paymentGateway>> așteaptă o notificare de la achizitor privind rezultatul plății. Încercați RETRIEVE_TRANSACTION din nou mai târziu sau urmăriți notificările de pe <<paymentGateway>>. |
response.gatewayCode=CANCELLEDresult=FAILURE |
Plătitorul a revocat interacțiunea pentru plata respectivă. Oferiți plătitorului opțiunea de a încerca o altă metodă de plată. |
response.gatewayCode=DECLINED or ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Plata a fost respinsă. Oferiți plătitorului opțiunea de a încerca o altă metodă de plată. În cazul unui ACQUIRER_SYSTEM_ERROR, poate fi util să solicitați achizitorului motivul pentru eșecul plății sau puteți încerca RETRIEVE_TRANSACTION din nou. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Tratați acest eveniment ca pe o plată respinsă. <<paymentGateway>> va încerca să se asigure că tranzacția nu a avut succes sau o va anula. |
Rambursări
Plățile WeChat Pay pot fi rambursate integral sau parțial. Trebuie să configurați rambursările în <<paymentGateway>> și în contul dvs. de comerciant de la furnizorul de servicii de plată prin browser.
Testarea integrării
<<paymentGateway>> furnizează un emulator de plăți prin browser care vă permite să vă testați integrarea WeChat Pay.