KR.smartForm.onClick()
Descriptif
KR.smartForm.onClick() permet d'effectuer des traitements personnalisés avant que le client JavaScript valide le formulaire et effectue l'appel pour créer une transaction.
- KR.smartForm.onClick(({
paymentMethod,action,formId}))
La fonction supporte ces paramètres :
1. paymentMethod
Ce paramètre correspond au moyen de paiement.
| Valeur | Description |
|---|---|
| null | Paramètre non utilisé. |
[SELECTED_PAYMENT_METHOD] | Clic sur le bouton du moyen de paiement. Ex : PAYPAL,CARDS, APPLE_PAY. Voir : tableau des moyens de paiement. |
Pour une intégration avec un wallet (voir : Gestion des wallets acheteur), avec le formAction valorisé à CUSTOMER_WALLET, utilisez ces valeurs :
| Valeur | Description |
|---|---|
| WALLET_CARDS | Clic sur le bouton du portefeuille électronique (wallet) pour les cartes. |
| <!-- | WALLET_PAYPAL Clic sur le bouton du portefeuille électronique (wallet) pour PayPal. --> |
2. action
Ce paramètre correspond à une action.
| Valeur | Description |
|---|---|
| null | Paramètre non utilisé. |
| beforePaymentStart | Avant le paiement. |
| openPopin | Ouvrir une pop-in. |
3. formId
Ce paramètre est utile uniquement s'il y a plusieurs formulaires avec cette intégration embedded-form-glue.
| Valeur | Description |
|---|---|
| null | Paramètre non utilisé |
| formId | Identifiant du formulaire |
Il est possible d'arrêter la chaine d'exécution en retournant false à la fin du traitement :
| Valeur de retour | Comportement |
|---|---|
| false | l'exécution est interrompue. La gestion d'erreur n'a pas lieu. La transaction n'est pas créée. |
| true | l'exécution continue normalement lorsque la callback est exécutée. |
Exemple d'intégration
Exemple 1
Utilisez cette fonction pour obliger l'acheteur à cocher une case « accepter les termes et conditions ».
KR.smartForm.onClick(({paymentMethod, action, formId})=>{
// Check if terms and conditions has been accepted
return document.querySelector('input.terms-and-conditions-checkbox').checked
})Exemple 2
Utilisez cette fonction pour obliger l'affichage d'une pop-in.
KR.smartForm.onClick(({paymentMethod, action, formId})=>{
return action === 'openPopin'
})Exemple 3
Utilisez cette fonction pour bloquer uniquement le paiement par cartes, avant le paiement.
KR.smartForm.onClick(({paymentMethod, action, formId})=>{
return !(paymentMethod === 'CARDS' && action === 'beforePaymentStart')
})