Opérations ultérieures
Lorsque vous utilisez la méthode d'intégration Hosted Session, le processus de paiement d'une nouvelle commande commence par une transaction initiale, généralement une transaction PAY (Payer) ou AUTHORIZE (Autoriser). Pour obtenir la liste complète des transactions initiales disponibles, voir Transactions.
La transaction initiale définit toutes les informations importantes pour la commande, elle comprend :
- Les détails sur la commande elle-même (tels que l'ID, le montant et la devise).
- Le mode de paiement à utiliser pour le paiement.
- Les détails du paiement du payeur.
Si vous utilisez une transaction PAY (Payer) et que le payeur reçoit les marchandises qu'il a commandées et en est satisfait, la commande est terminée et aucune autre action n'est nécessaire. Toutefois, dans de nombreux scénarios, des transactions ultérieures peuvent être nécessaires pour gérer le reste du cycle de vie de la commande.
Scénarios ultérieurs
Les scénarios suivants sont des exemples de situations dans lesquelles vous devez envoyer des transactions ultérieures pour votre commande existante :
- Si vous utilisez une transaction
VERIFY(Vérifier), souvent créée avec un montant de la commande à zéro, comme transaction initiale pour vérifier les détails du compte du payeur, vous devez la faire suivre d'une transactionPAY(Payer) ouAUTHORIZE(Autoriser) pour définir le montant correct de la commande et initier le transfert d'argent. - Si vous utilisez une transaction
AUTHORIZE(Autoriser) comme transaction initiale, vous devez la faire suivre d'une transactionCAPTURE(Collecter) lorsque vous êtes prêt à expédier les marchandises et que vous voulez que l'argent change de main. Si votre capacité à expédier les marchandises ou à fournir le service est retardée, vous devrez peut-être également utiliser la transactionUPDATE AUTHORIZATION(Mettre à jour l'autorisation) pour conserver l'autorisation active jusqu'à ce que vous soyez prêt à la collecter. - Si la commande est annulée pour une raison quelconque, vous devez utiliser la transaction
VOID(Annuler) pour également l'annuler immédiatement sur la passerelle. Si les détails du paiement ont déjà été envoyés à la banque, vous devez également utiliser laVOIDtransaction pour l'annuler immédiatement avec la passerelle. Si les détails du paiement ont déjà été envoyés à la banque, vous devez utiliser la transactionREFUND(Rembourser) qui est également nécessaire si le payeur n'est pas satisfait de son achat et souhaite le retourner. Dans les rares cas où la transaction échoue parce que l'acquéreur a besoin d'une autorisation supplémentaire, vous pouvez utiliser une transactionREFUND(Rembourser) qui est également nécessaire si le payeur n'est pas satisfait de son achat et souhaite le retourner. Dans les rares cas où la transaction échoue parce que l'acquéreur nécessite une autorisation supplémentaire, vous pouvez utiliser uneREFERRALtransaction pour réessayer l'opération de paiement avec les détails supplémentaires nécessaires.
Les opérations d'API RETRIEVE TRANSACTION (Extraire la transaction) et RETRIEVE ORDER (Extraire la commande) peuvent également être considérées comme des transactions ultérieures, bien qu'elles ne soient utilisées que pour extraire les détails d'une commande existante et qu'elles n'aient aucun impact sur le cycle de vie de la commande. Pour une liste de toutes les transactions ultérieures disponibles, voir Transactions.
Lien avec la transaction initiale
Toutes les transactions relatives à une même commande doivent être liées afin que les différents systèmes de paiement, tels que ANZ eGate payment gateway et les banques, puissent les identifier comme appartenant à un même ensemble. Le lien se fait en utilisant le même order ID dans chaque transaction liée à la commande. L'order ID est fourni comme paramètre de chemin dans l'URL de la demande.
Données partagées dans les transactions ultérieures
Le fait de lier différentes transactions au sein d'une même commande signifie que vous ne devez fournir qu'une seule fois les données spécifiques relatives à la commande. La passerelle stocke les détails de la commande et peut les utiliser si nécessaire lors du traitement d'éventuelles transactions ultérieures.
Pour toute transaction ultérieure, vous ne devez fournir que les données spécifiques à cette transaction. Par exemple :
- Dans une transaction
CAPTURE(Collecter), indiquez le montant et la devise des marchandises que vous expédiez, qui peut correspondre au montant total ou partiel de la commande. - Dans une transaction
REFUND(Rembourser), indiquez le montant et la devise du remboursement que vous envoyez, qui peut correspondre au montant total ou partiel de la commande. - Dans une transaction
VOID(Annuler), vous devez indiquer l'ID de transaction exacte que vous souhaitez annuler. - Dans une transaction
REFERRAL(Renvoyer), indiquez le code d'autorisation qui permet à l'émetteur d'approuver la transaction qui a échoué précédemment.
Si vous fournissez des informations identiques dans plusieurs transactions au sein d'une commande, la passerelle les ignore. Si vous mettez à jour des informations lors d'une transaction ultérieure, la passerelle met à jour les détails de la commande en conséquence. Par exemple, vous avez d'abord indiqué une adresse d'expédition lors de la transaction AUTHORIZE (Autoriser) initiale et le payeur déménage. Vous pouvez ensuite ajouter une nouvelle adresse d'expédition à la transaction CAPTURE (Collecter).