Plug-in SimpleOffline

Contenu et emplacement

Le package plug-in SimpleOffline contient :

• Un bean de session sans état :
  • com.ibm.commerce.payments.plugin.simpleoffline.beans.SimpleOfflineBean
  • com.ibm.commerce.payments.plugin.simpleoffline.beans.SimpleOffline
  • com.ibm.commerce.payments.plugin.simpleoffline.beans.SimpleOfflineHome
• SimpleOfflinePlugin.xml Fichier - Le fichier XML contenant une liste des paramètres uniques requis pour chaque mode de paiement pris en charge par le plug-in
• Fichier PaymentMethod.xsd - Le document de schéma XML d'un descripteur spécial de plug-in SimpleOffline contenant une liste des paramètres uniques (propriétés plug-in) requis pour chaque mode de paiement pris en charge.
• PluginDeployment.xml - Le descripteur de déploiement du plug-in de paiement pour le plug-in SimpleOffline qui définit le plug-in.

  
  <?xml version="1.0" encoding="UTF-8"?>
  <Plugin xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../base/PaymentPlugin.xsd">
    <PluginInformation 
          jndi="ejb/com/ibm/commerce/payments/plugin/simpleoffline/beans/SimpleOfflineHome" 
          home="com.ibm.commerce.payments.plugin.simpleoffline.beans.SimpleOfflineHome"
                  name="SimpleOffline" 
                  version="1.0.0" 
                  vendor="IBM"
                  independentCredit="true"
                  virtualTerminal="none">
    </PluginInformation>
    <ProtocolProperties>
    <ProtocolProperty name="card_number" keep="true"/>
    <ProtocolProperty name="payment_method" keep="true"/>
    <ProtocolProperty name="account" keep="true"/>
    <ProtocolProperty name="cc_brand" keep="true"/>
    <ProtocolProperty name="expire_month" keep="true"/>
    <ProtocolProperty name="expire_year" keep="true"/>
    <ProtocolProperty name="billto_firstname" keep="true"/>
    <ProtocolProperty name="billto_lastname" keep="true"/>
    <ProtocolProperty name="billto_address1" keep="true"/>
    <ProtocolProperty name="billto_city" keep="true"/>
    <ProtocolProperty name="billto_stateprovince" keep="true"/>
    <ProtocolProperty name="billto_zipcode" keep="true"/>
    </ProtocolProperties>
  </Plugin>
  

  Le plug-in SimpleOffline ne nécessite pas l'utilisation de propriétés supplémentaires. Les mots clés requis peuvent être définis dans ce fichier à l'aide des éléments <ProtocolProperties> et <ProtocolProperty>. Les mots clés requis peuvent être définis dans le descripteur de déploiement du plug-in, le fichier PaymentSystemPluginMapping.xml ou les deux.

• Pour les modes de paiement prises en charge, un analyseur XML est fourni.

Le fichier .jar pour le plug-in et le descripteur de déploiement de plug-ins se trouve dans les répertoires suivants :

• WC_eardir/Payments-Plugin-SimpleOffline.jar
• workspace_dir/WC/xml/config/ payments/ppc/plugins/SimpleOffline/PluginDeployment.xml

Sécurité du plug-in SimpleOffline

Par défaut, les mots clés suivants sont configurés en tant que données sensibles dans le fichier PaymentSystemPluginMapping.xml pour le plug-in SimpleOffline :

• cc_cvc (code de vérification de la carte de crédit)
• cc_nameoncard (nom sur carte de crédit)

Vous pouvez ajouter de nouveaux mots clés au fichier PaymentSystemPluginMapping.xml.

Ces données sont conservées après qu'un paiement par carte de crédit en attente est approuvé manuellement dans une transaction hors ligne. Pour supprimer ces données, les superviseurs du service clientèle (ou les utilisateurs ayant l'autorité appropriée) peuvent utiliser HCL Commerce Accelerator pour éditer les données étendues pour la transaction.

Paiement et traitement de l'état du crédit SimpleOffline

Le plug-in SimpleOffline déplace les états de paiement et de crédit en fonction des spécifications de plug-in de paiement, à l'exception de ce qui suit. Le plug-in conservera les objets de paiement et de crédit dans l'état ing (Approbation, Crédit) en cas de besoin, car la transaction n'est pas traitée en temps réel. Le plug-in définit la zone d'état de l'objet FinancialTransaction.

Lorsque le plug-in SimpleOffline maintient une transaction de paiement ou de crédit en attente, un représentant du service clientèle (RSC) doit utiliser le menu Paiements dans HCL Commerce Accelerator pour modifier le paiement ou le crédit afin qu'il puisse passer à l'état suivant (Succès ou Echec). La transaction de modification déplace le paiement et le crédit depuis l'état ing.

Une étape manuelle est nécessaire pour effectuer la transaction afin de recevoir le paiement. Cette étape manuelle de modification du paiement en attente peut être effectuée à l'aide du menu Paiements dans HCL Commerce Accelerator. Lorsque l'état de paiement est Approbation en cours, une action Approuve a été effectuée, mais les résultats sont encore inconnus. L'opération finira par réussir ou échouer. Si le mode de paiement est défini pour rester dans l'état En attente (keepPendingStatus="true"), l'état cible de l'action Approuver est Approbation en cours. Contrôleur des plug-in de paiement remplacera l'état Approuvé ou Echoué en conséquence, en fonction de la valeur d'état sélectionnée par le RSC lors de la modification de la transaction en attente.

De même, lorsqu'un état de crédit est En cours de remboursement, une action Créditer a été effectuée, mais les résultats sont encore inconnus. L'opération finira par réussir ou échouer. Si le mode de paiement est défini pour rester dans l'état En attente (keepPendingStatus="true"), l'état cible de l'action Créditer est En cours de remboursement. Contrôleur des plug-in de paiement modifiera l'état en Approuvé ou Echoué en conséquence.

Messages du plug-in SimpleOffline

Le plug-in SimpleOffline n'utilise aucun regroupement de ressources de messages spéciaux et ne dispose donc pas de fichiers de propriétés supplémentaires pour la traduction de messages. Il utilise les fonctions de messagerie standard décrites dans la spécification du plug-in Payment.