Intégration par redirection

L'intégration par redirection est un processus simple et sécurisé qui utilise 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 au minimum, cette méthode ne nécessite donc pas une grande expérience de développement.

1. Le client choisit 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 le paramètre amount (montant du paiement dans les unités minimales de la devise) et le paramètre returnUrl (adresse vers laquelle le client sera redirigé après un paiement réussi à l'étape 9). Pour en savoir plus sur la redirection après paiement, lisez 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 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 la 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 obtenue 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 choisit l'option correspondante. Apprenez-en 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é à l'étape 3).
   

10. La boutique en ligne envoie une requête 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 requête 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 de la banque. Voir la liste des codes de réponse ici.
    Pour plus d'informations, voir la section Obtention du statut de commande.