Présentation des méthodes
Le client JavaScript supporte les méthodes lors de l'intégration : Initialiser le formulaire de paiement.
| Méthode | Description | Cas smartForm |
|---|---|---|
| KR.openPaymentMethod() | Appelé pour proposer directement un moyen de paiement en ouvrant une pop-in (ou un pop-up) sans donner le choix à l'acheteur. | oui |
| KR.getPaymentMethods() | Appelé pour lister les moyens de paiement disponibles. | oui |
| KR.field.focus() | Appelé pour donner le focus à un champ du formulaire. |
| KR.skeleton.show() ou KR.skeleton.hide() | Appelé pour afficher ou masquer le squelette du formulaire le temps d'un ou plusieurs traitements métiers. |
| KR.setFormConfig() | permet de surcharger les paramètres d'initialisation du formToken. |
| KR.setBrand() | Appelé pour forcer la détection du moyen de paiement. |
| KR.onFormCreated() | Le formulaire de paiement est prêt mais le contenu des iframes n'est pas encore chargé. |
| KR.onFormReady() | Le formulaire est prêt à être utilisé. |
| KR.submit() | Soumet le formulaire(). Équivalent au clic utilisateur sur le bouton du formulaire |
| KR.validate() | Obsolète, utiliser KR.validateForm() |
| KR.validateForm() | Appelé pour déclencher la validation locale du formulaire. |
Les méthodes suivantes sont obsolètes et ne sont plus supportées. **Elles ne doivent pas être utilisées** :
- KR.validate() : utiliser KR.validateForm()
- KR.registerPlugin()
Gestion de l'affichage en mode embarqué.
| Méthode | Description |
|---|---|
| KR.fields.pan.help.button.hide() | Masque l'icône d'aide du PAN |
| KR.fields.pan.help.button.show() | Affiche l'icône d'aide du PAN |
| KR.fields.cvv.hide() | Masque le CVV |
| KR.fields.cvv.show() | Affiche le CVV |
Gestion de l'affichage en mode Pop-in.
| Méthode | Description |
|---|---|
| KR.closePopin() | Ferme la Pop-in (si ouverte) |
| KR.openPopin() | Ouvre la Pop-in (si fermée) |
| KR.setShopName() | Change le nom de la boutique défini dans l'en-tête de la Pop-in. |
Gestion dynamique du formulaire (Ajout, retrait du DOM) :
| Méthode | Description |
|---|---|
| KR.addForm(CSS class or id) | Ajoute un formulaire dans un élément du DOM. Retourne un formId. |
| KR.attachForm(CSS class or id) | Obsolète, utilisez KR.renderElements(). |
| KR.renderElements(CSS class or id) | Active le formulaire sur un DOM existant. Retourne un formId. |
| KR.hideForm(formId) | Cache le formulaire. |
| KR.removeEventCallbacks() | Supprime toutes les callbacks précédemment attachées à l'aide des fonctions KR.on[*]. |
| KR.removeForms() | Supprime tous les formulaires du DOM (appelle automatiquement KR.removeEventCallbacks()). |
| KR.showForm(formId) | Affiche le formulaire. |
Vous pouvez consulter : [les exemples de codes sur GitHub](https://github.com/lyra/embedded-form-glue).
Manipulation du bouton de soumission du formulaire de paiement :
| Paramètre | Description |
|---|---|
| KR.button.setLabel('MON LABEL %amount-and-currency% ') | Définit un label ou %amount-and-currency% sera remplacé par le montant et la devise. |
| KR.button.showSpinner() | Affiche l'animation d'attente. |
| KR.button.hideSpinner() | Cache l'animation d'attente. |
| KR.button.disable() | Désactive le bouton (non clickable). |
| KR.button.enable() | Active le bouton. |