Bancontact

Pays & devises

Pays pris en charge

• Belgique

Devises prises en charge

• Euro (EUR)

Intégration

Nous proposons cette méthode de paiement pour les modes d'intégration suivants. Consultez nos guides dédiés pour en savoir plus sur leurs différences individuelles :

• Hosted Checkout Page
• Server-to-server
• Intégration mobile/client

Trouvez une vue d'ensemble dans le chapitre "Cinématique".

Selon le mode d'intégration, des différences s'appliquent :

• Hosted Checkout Page
• Server-to-server
• Intégration mobile/client

Hosted Checkout Page

Avant de commencer à traiter des transactions, configurez la méthode de paiement dans votre compte :

1. Connectez-vous au Merchant Portal. Allez dans Entreprise > Moyens de paiement > Bancontact. 
2. (Dé) cochez les modes de paiement disponibles que vos clients peuvent choisir sur le Hosted Checkout Page :
   

   Mode	Description
   Afficher le code QR	Permettez à vos clients de payer en scannant un code QR.
   Afficher l'intention URL	Permettez à vos clients de payer avec l'application Payconiq by Bancontact.

3. Cliquez sur "Mettre à jour Bancontact" pour confirmer vos choix
4. En fonction de votre choix, les modes suivants sont désormais disponibles pour les appareils respectifs :

   	Mobile	Tablette	Ordinateur
   Code QR	Non	Oui	Oui
   Intention URL	Oui	Oui	Non
   Carte Bancontact PAN	Oui	Oui	Oui

Quel que soit votre choix, l'option de paiement par carte Bancontact (PAN) est toujours disponible.

Vous êtes maintenant prêt à intégrer la méthode de paiement dans votre boutique en ligne ou votre application mobile.

Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout :

{
   "cardPaymentMethodSpecificInput":{
      "authorizationMode":"SALE",
      "paymentProductId":3012,
      "threeDSecure":{
         
      },
      "transactionChannel":"ECOMMERCE"
   },
   "hostedCheckoutSpecificInput":{
      "locale":"en_EN",
      "returnUrl":"https://yourReturnUrl.com"
   },
   "order":{
      "additionalInput":{
         
      },
      "amountOfMoney":{
         "amount":1000,
         "currencyCode":"EUR"
      },
      "customer":{
         "billingAddress":{
            "countryCode":"BE"
         }
      },
      "references":{
         "merchantReference":"Your reference"
      }
   }
}

Propriétés	Remarques
order.amountOfMoney      amount      currencyCode	amount : Le montant brut que vous souhaitez facturer pour cette commande. currencyCode : Le code devise ISO 4217 pour ce montant.
hostedCheckoutSpecificInput      returnURL      locale	returnURL : L'URL vers laquelle nous redirigeons vos clients après que le paiement a été finalisé. locale : La version linguistique de notre Hosted Checkout Page.
cardPaymentMethodSpecificInput.paymentProductId	paymentProductId : L'identifiant numérique de la méthode de paiement sur notre plateforme. Trouvez cet identifiant dans le chapitre "Aperçu". Il indique à notre plateforme d'envoyer vos clients directement à la version Bancontact de notre Hosted Checkout Page. En cas d'omission, notre plateforme redirige vos clients vers la Hosted Checkout Page, leur permettant de choisir ce mode de paiement ou tout autre actif dans votre compte.

Server-to-server

Ajoutez les propriétés suivantes à une requête standard CreatePayment :

{
   "cardPaymentMethodSpecificInput":{
      "card":{
         "cardholderName":"BCMC Buyer",
         "cardNumber":"0000000000000000",
         "expiryDate":"0130"
      },
      "threeDSecure":{
         "redirectionData":{
            "returnUrl":"https://yourReturnUrl.com"
         }
      },
      "authorizationMode":"SALE",
      "recurring":{
         
      },
      "transactionChannel":"ECOMMERCE",
      "paymentProductId":3012
   },
   "fraudFields":{
      "customerIpAddress":"40.91.241.131"
   },
   "order":{
      "additionalInput":{
         
      },
      "amountOfMoney":{
         "amount":1000,
         "currencyCode":"EUR"
      },
      "customer":{
         "billingAddress":{
            "countryCode":"BE"
         }
      },
      "references":{
         "merchantReference":"BDD_20230118060724344_UNNERD0101E1_SS_00"
      }
   }
}

Propriétés	Remarques
order.amountOfMoney      amount      currencyCode	amount : Le montant brut que vous souhaitez facturer pour cette commande currencyCode : Le code devise ISO 4217 pour ce montant
cardPaymentMethodSpecificInput      card           cardNumber           expiryDate           cardholderName      returnURL      paymentProductId	card : Les informations de la carte utilisée pour le paiement Assurez-vous de respecter les nécessaires exigences PCI DSS pour l'envoi de données sensibles returnURL : L'URL vers laquelle nous redirigeons vos clients une fois le paiement finalisé paymentProductId : L'identifiant numérique de la méthode de paiement sur notre plateforme. Trouvez cet identifiant dans le chapitre "Aperçu".

Intégration mobile/client

Comme cette méthode de paiement est disponible uniquement via Hosted Checkout Page pour les paiements mobiles, votre application doit implémenter le flux/la requête respective(s).

Consultez le chapitre "Cinématique" / chapitre Hosted Checkout Page pour en savoir plus.

Cinématique

Le Cinématique dépend de ces facteurs :

• Le mode d'intégration que vous choisissez pour cette méthode de paiement :
  Hosted Checkout Page
  Server-to-server
  Intégration mobile/client
  
  
• Le mode de paiement que vous offrez à vos clients :
  Code QR
  Intention URL
  Carte Bancontact PAN
  
  
• Le type d'appareil que vos clients utilisent pour le paiement :
  Mobile/Tablette
  Ordinateur

Pour vous aider à comprendre les flux de paiement résultants impliquant ces facteurs, jetez un œil à ce tableau qui vous mène aux chapitres individuels :

	Hosted Checkout Page	Server-to-server	Intégration mobile/client
Modes de paiement disponibles	Code QR Intention URL PAN	PAN	Intention URL (via Hosted Checkout Page)

Hosted Checkout Page

Ce mode d'intégration vous permet de traiter les transactions via les modes de paiement

• Code QR
  
• Intention URL
  
• PAN

Cinématique pour les codes QR

Ce flux implique l'interaction entre les appareils mobile/tablette et ordinateur de vos clients.

1. Vos clients finalisent une commande sur leur ordinateur dans votre boutique et sélectionnent cette méthode de paiement.
2. Vous envoyez cette requête CreateHostedCheckout à notre plateforme.
3. Vous redirigez vos clients sur leur ordinateur via le redirectUrl vers le Hosted Checkout Page.
4. Vos clients scannent le code QR affiché avec leur appareil mobile/tablette.
5. L'appareil mobile/tablette ouvre l'application Payconiq. Vos clients confirment le paiement dans l'application.
6. Nous recevons le résultat de la transaction.
7. L'appareil mobile/tablette ouvre le navigateur standard et redirige vos clients vers votre returnURL.
8. Nous redirigeons vos clients vers votre returnURL sur leur ordinateur.
9. Vous requête le résultat de la transaction à notre plateforme via GetHostedCheckout ou recevez le résultat via webhooks.
10. Si la transaction a réussi, vous pouvez livrer les biens / services.

Cinématique pour les intentions URL

Ce flux implique uniquement l'appareil mobile de vos clients.

1. Vos clients finalisent une commande sur leur appareil mobile dans votre boutique et sélectionnent cette méthode de paiement.
2. Vous envoyez la requête CreateHostedCheckout à notre plateforme.
3. Vous redirigez vos clients sur leur appareil mobile via le redirectUrl vers le Hosted Checkout Page. Vos clients cliquent sur le bouton "Ouvrir votre application".
4. L'appareil mobile ouvre l'application Payconiq. Vos clients confirment le paiement dans l'application.
5. Nous recevons le résultat de la transaction.
6. L'appareil mobile ouvre le navigateur par défaut et redirige vos clients vers votre returnURL
7. Vous requête le résultat de la transaction à notre plateforme via GetHostedCheckout ou recevez le résultat via webhooks.
8. Si la transaction a réussi, vous pouvez livrer les biens / services.

Cinématique pour la carte PAN Bancontact

Ce flux implique uniquement un appareil (soit l'appareil mobile/tablette de vos clients, soit leur ordinateur).

1. Vos clients finalisent une commande dans votre boutique et sélectionnent cette méthode de paiement.
2. Vous envoyez cette requête CreateHostedCheckout à notre plateforme.
3. Vous redirigez vos clients via le redirectUrl vers le Hosted Checkout Page.
4. Vos clients fournissent leur numéro de carte Bancontact. Nous les redirigeons vers leur émetteur pour l'authentification 3-D Secure.
5. Notre système reçoit le résultat de l'authentification 3-D de l'émetteur. Nous traitons la transaction et recevons le résultat de l'acquéreur.
6. Nous redirigeons vos clients vers votre returnURL
7. Vous demandez le résultat de la transaction à notre plateforme via GetHostedCheckout ou recevez le résultat via webhooks.
8. Si la transaction a réussi, vous pouvez livrer les biens / services.

Server-to-server

Ce mode d'intégration vous permet de traiter les transactions via le mode de paiement PAN.

Cinématique pour la carte PAN Bancontact

Ce flux implique uniquement un appareil (soit l'appareil mobile/tablette de vos clients, soit leur ordinateur).

1. Vos clients finalisent une commande dans votre boutique et sélectionnent cette méthode de paiement.
2. Vous envoyez cette requête CreatePayment à notre plateforme.
3. Notre plateforme envoie une réponse contenant un objet merchantAction, vous indiquant de rediriger vos clients vers leur émetteur pour l'authentification 3-D Secure.
4. Notre système reçoit le résultat de l'authentification 3-D de l'émetteur.
5. Nous traitons la transaction et recevons le résultat de l'acquéreur.
6. Nous redirigeons vos clients vers votre returnURL
7. Vous requête le résultat de la transaction à notre plateforme via GetPaymentDetails ou recevez le résultat via webhooks.
8. Si la transaction a réussi, vous pouvez livrer les biens / services.

Intégration mobile/client

Ce mode d'intégration vous permet de traiter les transactions via le mode de paiement intention URL.

Cinématique pour l'intention URL

Ce flux implique uniquement l'appareil mobile de vos clients.

1. Vos clients finalisent une commande dans votre application et sélectionnent cette méthode de paiement.
2. Votre serveur e-commerce envoie cette requête CreateHostedCheckout à notre plateforme.
3. Vous redirigez vos clients dans votre application vers le Hosted Checkout Page via le redirectUrl. Vos clients cliquent sur le bouton "Ouvrir votre application". Votre application enregistre l'identifiant de la session de paiement hébergé (hostedcheckoutsessionid) au début du paiement.
4. L'appareil mobile ouvre l'application Payconiq. Vos clients confirment le paiement dans l'application.
5. Nous recevons le résultat de la transaction.
6. Vous requête le résultat de la transaction à notre plateforme via GetHostedCheckout ou recevez le résultat via webhooks.
7. L'application Payconiq ouvre votre application en utilisant l'identifiant fourni à l'étape 3), affichant le résultat de la transaction.
8. Si la transaction a réussi, vous pouvez livrer les biens / services.

Test

Consultez nos Cas de test pour des données de test et des instructions détaillées.

Informations supplémentaires

Traiter les remboursements
Vous pouvez traiter des remboursements complets et partiels si vous avez traité la transaction d'origine via notre modèle Full Service.

Les options/conditions suivantes s'appliquent :

• La valeur du remboursement ne dépasse pas 100 % de la valeur de la transaction d'origine.
• Votre entreprise ne doit pas appartenir au code de catégorie commerçant 7995. Si c'est le cas, vous devez rembourser la transaction hors ligne.
• Vous pouvez effectuer le remboursement soit via le Merchant Portal soit notre API. Lorsque vous utilisez notre API, envoyez toujours le numéro de référence de la transaction d'origine dans votre requête.
• Le remboursement ne peut être effectué que sur le compte bancaire lié à la carte utilisée pour effectuer la transaction d'origine.