Activation du paiement avec validation

Vous pouvez activer les paiements avec validation dans votre magasin en utilisant le plug-in de paiement SimplePunchout. Lorsque les acheteurs paient, le paiement est effectué par l'intermédiaire d'un fournisseur de services de paiement tiers.

Pourquoi et quand exécuter cette tâche

La procédure suivante inclut des exemples de fichiers qui ont configuré un système de paiement appelé TestPunchoutSystem. Vous pouvez modifier les exemples de noms au besoin.

Remarque : 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.

Procédure

Téléchargez et extrayez le fichier payments.zip suivant dans le répertoire workspace_dir/WC/xml/config/.
Le package payments.zip comprend des exemples de fichiers pour configurer le mode de paiement, le mappage des paiements et le mappage de plug-in du système de paiement.
- payments.zip
Cela permettra de configurer :
- Exemple de système de paiement TestPunchoutSystem, qui mappe au plug-in de paiement CustomizationPlugin.
- L'exemple de configuration du mode de paiement TestPunchout, qui mappe au système de paiement TestPunchoutSystem.
- Mappage depuis le mode de paiement TestPunchout à la configuration de la méthode de paiement TestPunchout.
Assurez-vous qu'après extraction, votre environnement contient la structure de répertoire suivante.
- workspace_dir/WC/xml/config/payments/edp
- workspace_dir/WC/xml/config/payments/ppc
Vous pouvez modifier les noms du système de paiement, les modes de paiement et les configurations de la méthode de paiement en mettant à jour les fichiers dans les répertoires edp et ppc. Si vous modifiez le nom du système de paiement, assurez-vous de mettre également à jour les noms dans l'exemple de fichiers CSV dans les étapes précédentes pour correspondre à votre nouveau système de paiement.
Activez l'option de paiement avec validation dans votre magasin.
1. Connectez-vous au Centre de gestion.
2. Sélectionnez Gestion de magasin dans le menu principal.
3. Sélectionnez Magasins dans le cadre de navigation de gauche.
4. Sélectionnez le magasin que vous souhaitez configurer.
5. Dans la page Paiement des achats, cochez la case Paiement avec validation.

Ajoutez le mode de paiement avec validation à la base de données.

Insérez la stratégie de paiement pour TestPunchout dans la table POLICY :

Remarque : Assurez-vous que vous mettez à jour <UniquePolicyId>> et <StoreIdentifier> dans l'instruction suivante.

insert into policy (policy_id, policyname, policytype_id, storeent_id, properties) values (<UniquePolicyId>, 'TestPunchout', 'Payment', (select storeent_id from storeent where IDENTIFIER = '<StoreIdentifier>), 'attrPageName=TestPunchout&paymentConfigurationId=default&display=true&compatibleMode=false&uniqueKey=piId&PIKey=piId&punchoutPayment=true');

Insérez les descriptions traduites de la stratégie de paiement dans la table POLICYDESC. Vous pouvez insérer uniquement des descriptions en anglais.
```
insert into policydesc values(<UniquePolicyId>, -1, 'TestPunchout', 'TestPunchout', null, null, null);
```

Pour utiliser le contrôleur de plug-in de paiement, configurez les commandes de stratégie métier pour la nouvelle stratégie.

insert into policycmd values(<UniquePolicyId>, 'com.ibm.commerce.payment.actions.commands.DoPaymentActionsPolicyCmdImpl', null, null);
insert into policycmd values(<UniquePolicyId>, 'com.ibm.commerce.payment.actions.commands.EditPaymentInstructionPolicyCmdImpl', null, null);
insert into policycmd values(<UniquePolicyId>, 'com.ibm.commerce.payment.actions.commands.QueryPaymentsInfoPolicyCmdImpl', null, null);

Implémentez le code d'extension pour les points d'extension suivants pour qu'ils s'intègrent au fournisseur de services de paiement tiers.
- approve_payment
- get_punchout_url
- process_punchout_response
Pour plus d'informations sur ces points d'extension, voir Points d'extension de paiement avec validation.
Enregistrez le code d'extension que vous avez créé pour les trois points d'extension dans la base de données.
1. Créez des fichiers d'entrée à l'aide des mots clés CmdReg et UEConfig.
  Les fichiers d'entrée suivants sont fournis à titre d'exemple que vous pouvez utiliser et modifier au besoin.
  - TestPunchoutCmdReg.csv
    Ce fichier est utilisé pour charger les données afin d'enregistrer la commande de l'extension. Notez que la colonne InterfaceName contient les commandes qui sont étendues plus le nom du mode de paiement. Par exemple, com.ibm.commerce.payment.task.commands.GetPunchoutURLCmd+TestPunchout. Si vous avez modifié le nom du mode de paiement à partir du payments.zip, assurez-vous de mettre à jour le fichier CSV avec le nouveau nom du mode de paiement.
  - TestPunchoutUEConfig.csv
    Ce fichier est utilisé pour configurer l'extension, par exemple pour définir le chemin d'accès de l'URL et les propriétés ou filtres pour l'extension. L'exemple définit ce qui suit :
    
    Exemple de configuration de point d'extension pour approve_payment, qui mappe à POST extension/payment_test/approve_payment_pending sur le serveur de personnalisation.
    
    Exemple de configuration de point d'extension pour get_punchout_url, qui mappe à POST extension/payment_test/get_punchout_url sur le serveur de personnalisation.
    
    Exemple de configuration de point d'extension pour process_punchout_response, qui mappe à POST extension/payment_test/process_punchout_response sur le serveur de personnalisation.
2. Enregistrez les fichier d'entrée dans le répertoire WCDE_installdir/samples/DataLoad/xC.
3. Chargez les fichiers CmdReg et UEConfig dans la base de données.
Testez le mode de paiement dans votre magasin.
1. Ajout un article au panier dans votre magasin.
2. Sélectionnez TestPunchout comme mode de paiement lors de votre paiement.
  
  Votre code d'extension pour approve_payment est appelé lorsque la commande est soumise. Si l'état de la transaction financière est défini sur 1 (en attente) par votre code d'extension, un bouton Payer s'affiche.
3. Cliquez sur Payer.
  
  Votre code d'extension pour get_punchout_url est appelé lorsque vous cliquez sur Payer et une fenêtre contextuelle sur l'URL (renvoyée par votre code d'extension) s'affiche.
4. Indiquez le mode de paiement dans la fenêtre contextuelle.
  
  Votre code d'extension pour process_punchout_response est appelé quand POST cart/@self/payment_instruction/callback est appelé.

Que faire ensuite

Pour l'activer dans votre environnement de production :

Activez l'option Paiement avec vérification dans l'outil Centre de gestion de votre environnement de production.
Répétez les instructions SQL par rapport à votre base de données de production.
Enregistrez le code source dans votre référentiel de code source pour le pipeline CI/CD pour conditionner et déployer les personnalisations.
Chargez vos fichiers CSV de chargement de données dans votre environnement de production.