- Directives d'intégration
- Fonctionnalités prises en charge (Méthodes de paiement)
- Mise en œuvre d'une intégration du paiement avec redirection
- Paiements Sofortbanking
Intégration Sofortbanking
- Conditions préalables
- Intégration Sofortbanking
- Comment interpréter le résultat de la transaction
- Remboursements de paiements
- Test d'une intégration des paiements avec redirection
Paiements Sofortbanking
Sofortbanking est un système de paiement pour commerce électronique qui permet aux payeurs d'effectuer des achats en utilisant les virements en ligne directs à partir de leur compte bancaire. Les payeurs sont redirigés sur le site Web Sofortbanking où ils peuvent initier un virement en ligne direct.
Sofortbanking est une méthode de paiement avec redirection prise en charge par Mastercard Gateway. Cette page explique les détails de l'intégration spécifique à Sofortbanking. Nous vous recommandons de lire les instructions d'intégration pour les paiements avec redirection avant de créer une intégration Sofortbanking.
Les paiements avec redirection Sofortbanking ne sont pris en charge que pour les transactions libellées en EUR.
Conditions préalables
Pour proposer Sofortbanking comme méthode de paiement via Mastercard Gateway :
- Vous devez être inscrit auprès de votre fournisseur de services de paiements 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 fournisseur de services de paiements avec redirection.
- Vous devez disposer d’un compte bancaire dans l'une de ces devises prise en charge enregistré pour votre compte de commerçant chez votre fournisseur de services de paiements avec redirection.
Intégration Sofortbanking
Avec les intégrations Hosted Checkout version 50 et versions ultérieures, Sofortbanking est automatiquement disponible pour vos payeurs lorsque vous êtes activé et configuré pour cela par votre fournisseur de services de paiement.
Pour plus de détails, voir Intégration des paiements avec redirection via Hosted Checkout.
L'intégration Direct Payment vous permet de proposer la méthode de paiement Sofortbanking 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
pour le traitement des paiements Sofortbanking.
sourceOfFunds.type = SOFORT
browserPayment.operation = PAY
(l'opération Authorize (Autoriser) n'est pas prise en charge par Sofortbanking).sourceOfFunds.provided.sofort.bic
: BIC (Business Identifier Code) international pour le compte bancaire du payeur. Pour une expérience du payeur améliorée, il est recommandé de renseigner ce champ. Ce faisant, le payeur ne se verra pas présenter le formulaire de sélection de banque mais sera redirigé automatiquement vers sa banque.
Langue préférée
Vous pouvez définir la langue que vous préférez que Sofortbanking utilise pour les pages affichées au payeur en renseignant le champ browserPayment.preferredLanguage
dans la demande Initiate Browser Payment (Initialisation du paiement avec redirection). Toutefois, la langue n'est utilisée que si Sofortbanking la prend en charge.
{ "apiOperation":"INITIATE_BROWSER_PAYMENT", "browserPayment":{ "operation":"PAY", "returnUrl":"https://<return_url>" }, "order":{ "amount":"10.00", "currency":"EUR" }, "sourceOfFunds":{"type":"SOFORT" } }
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 Sofortbanking.
Réponse Initiate Browser Payment (Initier un paiement avec redirection) |
Qu’est-ce que cela signifie ? |
---|---|
response.gatewayCode=SUBMITTED result=SUCCESS |
Redirigez le payeur en utilisant l'URL fournie dans la réponse. |
Réponse Retrieve Transaction/Retrieve Order (Extraire la transaction/Extraire la commande) |
Qu’est-ce que cela signifie ? |
response.gatewayCode=APPROVED result=SUCCESS sourceOfFunds.provided.sofort.bic sourceOfFunds.provided.sofort.bankAccountNumber sourceOfFunds.provided.sofort.iban
|
Le paiement a réussi. |
response.gatewayCode= PENDING result=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= CANCELLED result=FAILURE |
Le payeur a annulé l'interaction pour ce paiement. Proposez au payeur d'essayer une autre méthode de paiement. |
response.gatewayCode= DECLINED or ACQUIRER_SYSTEM_ERROR result=FAILURE |
Le paiement a été refusé. Proposez au payeur d'essayer une autre méthode 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_OUT result=FAILURE |
Traitez cela comme un paiement refusé. Mastercard Gateway vérifiera que la transaction a échoué ou l'annulera. |
Remboursements
Vous pouvez rembourser les paiements Sofortbanking en partie ou en totalité. Les remboursements doivent être configurés pour vous sur la passerelle et sur votre compte de commerçant au niveau de votre fournisseur de services de paiement avec redirection.
Test de votre intégration
Mastercard Gateway propose un émulateur de paiements avec redirection qui vous permet de tester votre intégration Sofortbanking.