Points d'extension xC de paiement
Vous pouvez personnaliser la façon dont HCL Commerce s'intègre avec les passerelles de paiement tierces. Utilisez ces points d'extension pour personnaliser la façon dont HCL Commerce interagit avec les passerelles de paiement pour traiter les paiements pendant la capture des commandes.
La table suivante identifie les classes pour les commandes de paiement punch-out que vous pouvez personnaliser via une extension externalized customization.
Pour un exemple d'enregistrement du code d'extension et d'attribution du code au point d'extension, voir Activation du paiement avec validation.| Point d'extension | Lorsque le point d'extension est utilisé | Conseils d'implémentation du code d'extension | Formats de requêtes, de réponses | Exemple d'emplacement de code d'extension |
|---|---|---|---|---|
| approve_payment | L'opération de paiement du panier (POST cart/@self/checkout) appelle le point d'extension approve_payment pour autoriser le paiement. | Le code d'extension approve_payment doit renvoyer la transaction financière mise à jour avec son état défini sur 1 (en attente) pour lancer le paiement punch-out. | PaymentApproveCmdUEInput, PaymentApproveCmdUEOutput | Méthode approvePayment dans workspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
| get_punchout_url | L'opération de renseignement sur l'obtention du paiement punch-out (GET cart/@self/payment_instruction/punchoutPaymentInfo) appelle le point d'extension get_punchout_url pour obtenir l'URL du formulaire de paiement. | Le code d'extension get_punchout_url doit renvoyer l'URL du formulaire de paiement. Important: La méthode encryptByMD5 qui était auparavant présente dans PunchoutPaymentUtil.java n'est plus prise en charge et a été supprimée.Assurez-vous que vos extensions ne reposent pas sur cette méthode. | GetPunchoutURLCmdUEInput, GetPunchoutURLCmdUEOutput | Méthode getPunchoutURL dans workspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
| process_punchout_response | L'opération de rappel (POST cart/@self/payment_instruction/callback) appelle le point d'extension process_punchout_response pour traiter les paramètres de rappel du fournisseur de services de paiement. | Le code d'extension process_punchout_response doit appeler le fournisseur de services de paiement pour vérifier les paramètres de rappel, renvoyer les paramètres de réponse avec le paramètre "punchoutTranResult" défini sur "successful", "failed" ou "invalid", et mettre à jour les données étendues de l'instruction de paiement pour inclure des informations supplémentaires. | ProcessPunchoutResponseCmdUEInput, ProcessPunchoutResponseCmdUEOutput | Méthode processPunchoutResponse dans workspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
La table suivante identifie les classes de création de jetons de paiement que vous pouvez personnaliser via une extension externalized customization.
Pour un exemple d'enregistrement du code d'extension et d'attribution du code au point d'extension, voir Activation de l'utilisation de jetons (tokenization) de paiement.
| Point d'extension | Lorsque le point d'extension est utilisé | Conseils d'implémentation du code d'extension | Formats de requêtes, de réponses | Exemple d'emplacement de code d'extension |
|---|---|---|---|---|
| create_payment_token | L'opération d'ajout d'instructions de paiement (POST cart/@self/payment_instruction) ou l'opération de mise à jour de profil de paiement (PUT person/@self/checkoutProfile) appelle le point d'extension create_payment_token pour créer le jeton de paiement. | Le code d'extension create_payment_token doit appeler le fournisseur de services de paiement pour créer les jetons des informations de paiement dans les données du protocole et renvoyer le jeton de paiement et sa valeur d'affichage en tant que paires clé-valeur "payment_token" et "display_value" dans les données de jeton. | CreatePaymentTokenCmdUEInput, CreatePaymentTokenCmdUEOutput | Méthode createPaymentToken dans workspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
| update_payment_token | L'opération de mise à jour d'instructions de paiement (PUT cart/@self/payment_instruction) ou l'opération de mise à jour de profil de paiement (PUT person/@self/checkoutProfile) appelle le point d'extension update_payment_token pour créer le jeton de paiement. | Le code d'extension update_payment_token doit appeler le fournisseur de services de paiement pour recréer les jetons des données de jetons existantes avec les informations de paiement mises à jour dans les données de protocole et renvoyer le jeton de paiement et sa valeur d'affichage mis à jour en tant que paires clé-valeur "payment_token" et "display_value" dans les données de jeton. | UpdatePaymentTokenCmdUEInput, UpdatePaymentTokenCmdUEOutput | Méthode updatePaymentToken dans workspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
| remove_payment_token | L'opération de suppression d'instructions de paiement (DELETE cart/@self/payment_instruction/{piId}) appelle le point d'extension remove_payment_token pour supprimer le jeton de paiement. | Le code d'extension remove_payment_token doit appeler le fournisseur de services de paiement pour supprimer le jeton de paiement (en tant que paire clé-valeur "payment_token" dans les données de jetons) de sa base de données. | RemovePaymentTokenCmdUEInput, RemovePaymentTokenCmdUEOutput | Méthode removePaymentToken dans workspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
| approve_payment | L'opération de paiement du panier (POST cart/@self/checkout) appelle le point d'extension approve_payment pour autoriser le paiement. | Le code d'extension approve_payment doit appeler le fournisseur de services de paiement avec les données de jetons enregistrées dans les données du protocole pour traiter le paiement et renvoyer la transaction financière mise à jour avec son état défini sur 2 (réussite) ou 3 (échec). | PaymentApproveCmdUEInput, PaymentApproveCmdUEOutput | Méthode createPaymentToken dans workspace_dir/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/PaymentResource.java |
Note: La méthode encryptByMD5 pour PunchoutPaymentUtil est obsolète depuis WebSphere Commerce version 7 et est à présent supprimée. Vous devez personnaliser le code si vous utilisez la même méthode.