- Directives d'intégration
- Fonctionnalités prises en charge (Modes de paiement)
- Mise en œuvre d'une intégration des paiements avec redirection
- Paiements Boleto Bancário
Boleto Bancário
Boleto Bancário est un système de paiement pour commerce électronique utilisé au Brésil qui permet aux payeurs d'effectuer des achats en payant en espèces ou via des paiements par des banques en ligne. Lorsque le payeur sélectionne Bancário sur la page de paiement et effectue un paiement en espèces, les détails du paiement sont affichés à l'écran et peuvent être imprimés. Le payeur peut ensuite payer le montant requis pour l'achat à un emplacement Boleto Bac¡rio. Pour les paiement par des banques en ligne, le payeur entre les détails Boleto Bancário, puis vérifie et autorise le paiement. Dans tous les cas, une fois le paiement effectué, vous en êtes informé et les marchandises peuvent être déclarées comme devant être expédiées au payeur.
Boleto Bancário est un mode de paiement avec redirection prise en charge sur Mastercard Gateway. Cette page explique les détails de l'intégration spécifique à Boleto Bancário. Nous vous recommandons de lire les instructions d'intégration pour les paiements avec redirection avant de créer une intégration Boleto Bancário.
Les paiements avec redirection Boleto Bancário ne sont pris en charge que pour les transactions en USD.
- Pour des raisons de sécurité, Boleto n'est accessible sur Mastercard Gateway que pendant 48 heures ou un maximum de cinq fois, après quoi Boleto n'est plus disponible. Le paiement Boleto expirera conformément à votre configuration.
- Les paiements Boleto sont toujours générés sous forme de fichiers PDF. Si vous avez besoin que ces fichiers soient disponibles pour les payeurs pendant une période prolongée, vous devez en enregistrer des copies sur votre serveur local.
Conditions préalables
Pour proposer Boleto Bancário comme mode de paiement via Mastercard Gateway :
- vous devez être inscrit auprès de votre prestataire de services de paiement avec redirection,
- votre profil de commerçant sur la passerelle doit être configuré en utilisant les détails de votre compte auprès de votre prestataire de services de paiement avec redirection,
- vous devez disposer d'un compte bancaire dans l'une des devises prise en charge enregistré pour votre compte de commerçant chez votre prestataire de services de paiement avec redirection.
Intégration Boleto Bancário
Boleto Bancário via Hosted Checkout sera bientôt disponible. Pour plus d'informations, veuillez contacter votre your payment service provider.
Direct Payment vous permet de proposer le mode de paiement Boleto Bancário sur votre propre page de paiement.
En plus des champs standard requis dans une demande de paiement avec redirection, vous devez renseigner les champs suivants dans la demande Initiate Browser Payment (Lancer un paiement avec redirection) :
sourceOfFunds.type=BOLETO_BANCARIObrowserPayment.operation=PAY(l'opération Authorize [Autoriser] n'est pas prise en charge par Boleto Bancário)billing.address.*: détails de l'adresse de facturation du payeur.customer.email: adresse électronique du payeur.customer.account.id: votre identifiant pour le compte du payeur avec vous.customer.nationalId: identifiant du payeur attribué par une autorité gouvernementale.sourceOfFunds.provided.boletoBancario.bankAccountHolder: nom du titulaire du compte bancaire pour le compte bancaire du payeur.
Langue préférée
Vous pouvez définir la langue que vous préférez que Boleto Bancário utilise pour les pages affichées au payeur en renseignant le champ browserPayment.preferredLanguage dans la demande Initiate Browser Payment (Lancer un paiement avec redirection). Toutefois, la langue n'est utilisée que si Boleto Bancário la prend en charge.
{
"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"
}
}
}
}
Comment interpréter le résultat de la transaction
Le tableau ci-dessous illustre les codes de réponse de transaction pour les scénarios possibles auxquels vous pouvez devoir faire face après avoir initié un paiement Boleto Bancário.
| Réponse Initiate Browser Payment (Lancer un paiement avec redirection) | Qu'est-ce que cela signifie ? |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Redirigez le payeur en utilisant l'URL indiquée dans la réponse. |
| Réponse Retrieve Transaction/Retrieve Order (Extraire une transaction/Extraire une commande) | Qu'est-ce que cela signifie ? |
response.gatewayCode=APPROVEDresult=SUCCESS |
Le paiement a réussi. |
response.gatewayCode=PENDINGresult=PENDING |
Mastercard Gateway attend une notification de l'acquéreur à propos du résultat du paiement. Réessayez la transaction RETRIEVE_TRANSACTION ou surveillez les notifications de Mastercard Gateway. |
response.gatewayCode=CANCELLEDresult=FAILURE |
Le payeur a annulé l'interaction pour ce paiement. Proposez au payeur d'essayer un autre mode de paiement. |
response.gatewayCode=DECLINED ou ACQUIRER_SYSTEM_ERRORresult=FAILURE |
Le paiement a été refusé. Proposez au payeur d'essayer un autre mode de paiement. Dans le cas d'une erreur ACQUIRER_SYSTEM_ERROR, vous pouvez vouloir demander à l'acquéreur la raison de l'échec du paiement, ou vous pouvez réessayer la transaction RETRIEVE_TRANSACTION. |
response.gatewayCode=TIMED_OUTresult=FAILURE |
Traitez cela comme un paiement refusé. Mastercard Gateway vérifiera que la transaction a échoué ou l'annulera. |
Test de votre intégration
Mastercard Gateway propose un émulateur de paiements avec redirection qui vous permet de tester votre intégration Boleto Bancário.