- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Implementarea unei integrări pentru plată prin browser
- Plățile Boleto Bancário
Boleto Bancário
Boleto Bancário este un serviciu de plăți pentru comerțul electronic utilizat în Brazilia, care permite plătitorilor să efectueze achiziții folosind fie numerar, fie plăți prin banking online. Când plătitorul selectează Boleto Bancário pe pagina de validare și continuă cu o plată în numerar, detaliile plății sunt afișate pe ecran și pot fi imprimate. Plătitorul poate plăti apoi suma necesară pentru achiziție într-o locație Boleto Bancário. Pentru plățile prin banking online, plătitorul introduce detaliile Boleto Bancário, apoi verifică și autorizează plata. În ambele cazuri, odată plata efectuată, veți primi o notificare, iar bunurile pot fi expediate către plătitor.
Boleto Bancário este o metodă de plată prin browser acceptată în Mastercard Gateway. Această pagină descrie detaliile integrării specifice metodei Boleto Bancário. Este recomandat să citiți ghidul de integrare pentru plățile prin browser înainte de a crea o integrare Boleto Bancário.
Plățile prin browser Boleto Bancário sunt acceptate numai pentru tranzacțiile în moneda USD.
- Din motive de securitate, Boleto poate fi accesat în Mastercard Gateway de maximum cinci ori în 48 de ore, după care Boleto nu va mai fi disponibil. Plata Boleto va expira conform configurației dvs.
- Boleto sunt întotdeauna generate ca fișiere PDF. Dacă doriți ca aceste fișiere să fie disponibile pentru plătitori pe o perioadă prelungită de timp, trebuie să salvați copii ale acestora pe serverul dvs. local.
Cerințe preliminare
Pentru a oferi Boleto Bancário ca metodă de plată în Mastercard Gateway:
- 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.
Integrarea Boleto Bancário
Serviciul Boleto Bancário prin Hosted Checkout va fi disponibil în curând. Vă rugăm să contactați your payment service provider pentru mai multe informații.
Integrarea Direct Payment vă permite să oferiți metoda de plată Boleto Bancário 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=BOLETO_BANCARIObrowserPayment.operation=PAY(operațiunea Authorize nu este acceptată de serviciul Boleto Bancário).billing.address.*: Detaliile adresei de facturare a plătitorului.customer.email: Adresa de email a plătitorului.customer.account.id: Identificatorul dvs. pentru numărul de contul al plătitorului.customer.nationalId: Un identificator pentru plătitor, emis de o autoritate guvernamentală.sourceOfFunds.provided.boletoBancario.bankAccountHolder: Numele posesorului contului bancar al plătitorului.
Limba preferată
Puteți seta limba în care doriți ca serviciul Boleto Bancário să afișeze paginile pentru plătitor, completând câmpul browserPayment.preferredLanguage din solicitarea Initiate Browser Payment. Însă limba va fi utilizată doar dacă este acceptată de Boleto Bancário.
{
"apiOperation": "INITIATE_BROWSER_PAYMENT",
"billing": {
"address": {
"street": "10 Upper Bank Street",
"postcodeZip": "E14 5NP",
"city": "London",
"country": "GBR"
}
},
"browserPayment": {
"operation": "PAY",
"returnUrl": "<your_merchant_URL>"
},
"customer": {
"email": "john.smith@example.com",
"account": {
"id": "1234567890"
},
"nationalId": "1234567890"
},
"order": {
"amount": "10.00",
"currency": "USD"
},
"sourceOfFunds": {
"type": "BOLETO_BANCARIO",
"provided": {
"boletoBancario": {
"bankAccountHolder": "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 Boleto Bancário.
| 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=SUCCESS |
Plata a fost realizată cu succes. |
response.gatewayCode=PENDINGresult=PENDING |
Mastercard Gateway 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 Mastercard Gateway. |
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 sau 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ă. Mastercard Gateway va încerca să se asigure că tranzacția nu a avut succes sau o va anula. |
Testarea integrării
Mastercard Gateway furnizează un emulator de plăți prin browser care vă permite să vă testați integrarea Boleto Bancário.