Données étendues dans les paiements ou les crédits
Certains plug-ins de paiement requièrent des données ou mots clés de protocole supplémentaires pour communiquer avec un système d'arrière-plan. Ces données de protocole supplémentaires appelées extended data s'ajoutent aux attributs standard définis dans la définition PaymentInstruction. Les données étendues sont des données autres que la devise, le montant de l'instruction de paiement et le nom du mode de paiement. Par exemple, le numéro de carte de crédit, l'expiration et l'adresse de facturation sont des données étendues.
Collecte de données étendues
Les données étendues sont collectées de la manière suivante :
- Fragments JSP pour un mode de paiement particulière
Par exemple, un fragment JSP peut recueillir des informations de carte de crédit, telles que le numéro de carte de crédit, la date d'expiration et l'année d'expiration. Le mode de paiement par chèque électronique utilise un ensemble différent de mots clés qui inclut un numéro de chèque et un numéro de routage de chèque.
- Fichier du descripteur de déploiement de plug-ins.
Si la valeur des données étendues est la même pour toutes les transactions de paiement qui utilisent le plug-in (par exemple, le nom d'hôte du serveur de paiement). Ensuite, configurez le fichier du descripteur de déploiement de plug-ins. Voir Spécification de plug-in Payment
Utilisez les paramètres de protocole de la classe ExtendedData pour fournir vos propres définitions de système d'arrière-plan afin que toutes les informations relatives à PaymentInstruction puissent être transmises au plug-in. Par exemple, utilisez
cc_brandpour Carte de crédit etcheck_routing_numberpour Chèque. En outre, si votre plug-in a des besoins spécifiques lors de l'invocation des méthodes checkPaymentInstruction ou validatePaymentInstruction, le plug-in peut ajouter des mots clés spécifiques que Contrôleur des plug-in de paiement peut stocker et utiliser dans les transactions ultérieures via PaymentInstruction. Par exemple, des mots clés peuvent être ajoutés pour représenter les informations générées ou obtenues par le plug-in, telles que les ID aléatoires ou les données externes interrogées par le plug-in.
Modification des données étendues
Utilisez HCL Commerce Accelerator pour ajouter, modifier ou supprimer des données étendues pour les instructions de paiement, les paiements en attente ou les transactions de crédit. Les données étendues d'une instruction de paiement répertorient à la fois les mots clés de protocole communs et les mots clés uniques requis pour un mode de paiement. Cette liste correspond à la liste des mots clés trouvés dans le fragment JSP prenant en charge le mode de paiement.
Paramètres facultatifs pour tous les modes de paiement
- order_id
- L'identificateur unique de la commande.
order_idpeut être nul quand il s'agit d'une instruction de remboursement. Siorder_idn'est pas fourni, alorsrma_iddoit être fourni. - rma_id
- L'identificateur de l'autorisation de retour de marchandise. Si
rma_idn'est pas fourni, alorsorder_iddoit être fourni.
Paramètres requis pour tous les modes de paiement
payMethodId est requis pour tous les modes de paiement. En outre, il est fortement recommandé de transmettre un paramètre policyId depuis la vitrine. Il s'agit d'un paramètre très utile pour le traitement des commandes.
Paramètres requis lors de l'utilisation du système de vérification des adresses (AVS)
Pour utiliser la fonction AVS, vous devez transmettre un paramètre billing_address_id, ou cinq paramètres qui s'associent, pour fournir ces informations ensemble. A savoir, billto_firstname, billto_lastname, billto_address1, billto_city et billto_stateprovince.
Paymentech spécifique
Sauf indication contraire, ces attributs sont facultatifs.
- paymethodId
- [ brand ]. Il s'agit d'un attribut obligatoire.
- compte
- Le numéro de carte de crédit. Il s'agit d'un attribut obligatoire.
- expire_year
- L'année d'expiration du compte. Il s'agit d'un attribut obligatoire.
- expire_month
- Le mois d'expiration du compte. Il s'agit d'un attribut obligatoire.
- expire_day
- Le jour d'expiration du compte
- billto_firstname
- Le prénom du titulaire du compte
- billto_middlename
- Le deuxième prénom du titulaire du compte
- billto_lastname
- Le nom de famille du titulaire du compte
- billto_address1
- L'adresse de facturation 1
- billto_address2
- L'adresse de facturation 2
- billto_address3
- L'adresse de facturation 3
- billto_city
- La ville de facturation
- billto_stateprovince
- L'état ou la province de facturation
- billto_zipcode
- Le code postal de facturation
- billto_country
- Le pays de facturation (code numérique ISO 3166)
- billto_phone_number
- Le numéro de téléphone de facturation
- cc_brand
- Marque de la carte de crédit. Il s'agit d'un attribut obligatoire.
- cc_cvc
- Le code de vérification de la carte
- cc_nameoncard
- Le nom sur la carte (titulaire de la carte). Il s'agit d'un attribut obligatoire.
- cc_cavv
- Valeur de vérification pour authentification du titulaire de la carte
- cc_xid
- Identifiant de transaction
- billto_telephonetype
- Le type de téléphone de facturation
- billto_telephonenumber
- Le numéro de téléphone de facturation
- cc_cardsecuritypresence
- La présence de sécurité de la carte
Spécifique aux cartes de crédit
- payment_method
- [ brand ]
- account
- Le numéro de carte de crédit. Il s'agit d'un attribut obligatoire.
- expire_year
- L'année d'expiration du compte. Il s'agit d'un attribut obligatoire.
- expire_month
- Le mois d'expiration du compte. Il s'agit d'un attribut obligatoire.
- expire_day
- Le jour d'expiration du compte
- billto_firstname
- Le prénom du titulaire du compte
- billto_middlename
- Le deuxième prénom du titulaire du compte
- billto_lastname
- Le nom de famille du titulaire du compte
- billto_address1
- L'adresse de facturation 1
- billto_address2
- L'adresse de facturation 2
- billto_address3
- L'adresse de facturation 3
- billto_city
- La ville de facturation
- billto_stateprovince
- L'état ou la province de facturation
- billto_zipcode
- Le code postal de facturation
- billto_country
- Le pays de facturation (code numérique ISO 3166)
- billto_phone_number
- Le numéro de téléphone de facturation
- cc_brand
- La marque de la carte de crédit.
- cc_cvc
- Le code de vérification de la carte
- cc_nameoncard
- Le nom sur la carte (titulaire de la carte)
- CAVV
- Valeur de vérification pour authentification du titulaire de la carte
- XID
- Identifiant de transaction
Chèque électronique spécifique
- payment_method
- Vérification
- compte
- Numéro du chèque-cadeau/de la carte (valeur stockée)
- billto_firstname
- Le prénom du titulaire du compte
- billto_middlename
- Le deuxième prénom du titulaire du compte
- billto_lastname
- Le nom de famille du titulaire du compte
- billto_address1
- L'adresse de facturation 1
- billto_address2
- L'adresse de facturation 2
- billto_address3
- L'adresse de facturation 3
- billto_city
- La ville de facturation
- billto_stateprovince
- L'Etat ou à la providence de facturation
- billto_zipcode
- Le code postal de facturation
- billto_country
- Le pays de facturation (code numérique ISO 3166)
- billto_phone_number]
- Le numéro de téléphone de facturation
- check_routing_number
- L'identificateur unique de la banque ; aux Etats-Unis, le numéro de routage de l'American Bankers Association (ABA). Il s'agit d'un attribut obligatoire.
- check_number
- Le numéro de chèque. Il s'agit d'un attribut obligatoire.
Chèques-cadeaux (GCt), Cartes-cadeaux (GCd) et Cartes de valeur stockée (SV) en général
- payment_method
- [ storedValue | giftCertificate | giftCard ]
- compte
- Numéro du chèque-cadeau/de la carte (valeur stockée)
- expire_year
- L'année d'expiration du compte
- expire_month
- Le mois d'expiration du compte
- expire_day
- Le jour d'expiration du compte
- sv_issue_year
- L'année de la délivrance de la carte/du certificat
- sv_issue_month
- Le mois de délivrance de la carte/du certificat
- sv_issue_day
- Le mois de délivrance de la carte/du certificat
- sv_issuer
- Le nom de l'entreprise/organisation qui délivre la carte/le certificat
Contre remboursement (COD) ou Facturation différée
- payment_method
- [ COD | BillMeLater]
- billto_firstname
- Le prénom du titulaire du compte
- billto_middlename
- Le deuxième prénom du titulaire du compte
- billto_lastname
- Le nom de famille du titulaire du compte
- billto_address1
- L'adresse de facturation 1
- billto_address2
- L'adresse de facturation 2
- billto_address3
- L'adresse de facturation 3
- billto_city
- La ville de facturation
- billto_stateprovince
- L'état ou la province de facturation
- billto_zipcode
- Le code postal de facturation
- billto_country
- Le pays de facturation (code numérique ISO 3166)
- billto_phone_number
- Le numéro de téléphone de facturation
Ligne de crédit
- payment_method
- creditLine
- compte
- Le compte de ligne de crédit