Intégration via redirection

L'intégration via redirection est un processus simple et sécurisé utilisant la page de paiement du côté de la passerelle de paiement. Le principal avantage est que vous n'avez pas besoin de collecter et traiter les données de carte sur votre site. Dans ce cas, l'API est utilisée de manière minimale, cette méthode ne nécessite donc pas une grande expérience de développement.

1. Le client sélectionne un produit dans la boutique en ligne et clique sur le bouton Acheter.

2. Le serveur de la boutique en ligne reçoit la demande d'achat.

3. Le serveur de la boutique en ligne demande l'enregistrement de la commande en envoyant un appel API register.do à la passerelle de paiement. Cette demande doit contenir les paramètres amount (montant du paiement en unités minimales de devise), orderNumber (numéro unique de commande dans le système du marchand) et returnUrl (adresse vers laquelle le client sera redirigé après un paiement réussi à l'étape 9). En savoir plus sur la redirection après paiement ici.

   Exemple de demande :

   curl --request POST \
   --url https://dev.bpcbt.com/payment/rest/register.do \
   --header 'content-type: application/x-www-form-urlencoded' \
   --data amount=2000 \
   --data currency=978 \
   --data userName=test_user \
   --data password=test_user_password \
   --data orderNumber=1234567890ABCDEF \
   --data returnUrl=https://mybestmerchantreturnurl.com \
   --data description=my_first_order \
   --data language=en

   Vous pouvez également retenir le montant sur le compte jusqu'au débit des fonds à l'aide de l'appel registerPreAuth.do. Pour en savoir plus sur la retenue et la finalisation, cliquez ici.

4. Le serveur de la passerelle de paiement enregistre la commande et envoie une réponse au serveur de la boutique en ligne. La réponse contient le paramètre formUrl (URL de paiement vers laquelle la boutique en ligne doit rediriger l'acheteur à l'étape 5) et le paramètre orderId (numéro unique de commande dans le système de la passerelle de paiement, sera utilisé à l'étape 10).

   Exemple de réponse :

   {
   "orderId": "01491d0b-c848-7dd6-a20d-e96900a7d8c0",
   "formUrl": "https://dev.bpcbt.com/payment/merchants/payment_en.html?mdOrder=01491d0b-c848-7dd6-a20d-e96900a7d8c0"
   }

5. La boutique en ligne redirige l'acheteur vers l'URL reçue dans le paramètre formUrl. La redirection peut être effectuée dans la même fenêtre ou dans une nouvelle fenêtre.

6. La passerelle de paiement ouvre le lien de paiement.

7. Le client saisit le numéro de sa carte, sa date d'expiration et le CVV/CVC et clique sur Payer.

   Alternativement, vous pouvez utiliser des paiements tokenisés via les portefeuilles Apple Pay, Samsung Pay ou Google Pay. Dans ce cas, l'acheteur sélectionne l'option correspondante. En savoir plus sur l'utilisation des paiements tokenisés ici.

8. La passerelle de paiement traite la demande de paiement.

9. L'acheteur est redirigé vers la page de la boutique en ligne spécifiée dans le paramètre returnUrl (spécifiée à l'étape 3)
   

10. La boutique en ligne envoie une demande getOrderStatusExtended.do à la passerelle de paiement pour vérifier le statut de la commande et s'assurer que la commande est effectivement payée. La demande contient le paramètre orderId reçu à l'étape 4. En réponse, la passerelle de paiement retourne le statut de la commande dans le paramètre orderStatus. Le statut 2 signifie un paiement réussi. De plus, le paramètre actionCode est retourné — il contient le code de réponse du traitement bancaire. Voir la liste des codes de réponse ici.
    Pour plus d'informations, voir la section Obtention du statut de commande.