• France
état des services
Back Office Marchand
assistance
FAQContacter le support
Video tutorials
Rechercher
Catégories
Tags
Français
Français
Anglais
Accueil
Cas d'usage
Créer un paiement
Créer un paiement en plusieurs fois
Proposer un paiement complémentaire
Créer un paiement par alias (token)
Créer un lien de paiement
Créer un abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
Intégration mobile
Échange de fichiers
Exemples de code
Logos
Push mail
Moyens de paiement
Modules de paiement
Guides
Back Office Marchand
Guides fonctionnels

userPaymentMethodsOrder

Description

Ce paramètre est un tableau et permet de gérer l'ordre d'affichage des moyens de paiement proposés à l'acheteur.
Utilisez ce paramètre avec cette méthode KR.setFormConfig() pour surcharger les paramètres d'initialisation.

Prérequis : la disponibilité du moyen de paiement

Pour gérer l'ordre d'affichage, vérifiez la disponibilité du moyen de paiement (en fonction de la devise, du montant minimum ou maximum, des contraintes techniques,...)  :

  • S'il est dans la liste des moyens paiements compatibles (Voir Liste des moyens de paiement compatibles).
  • Si son contrat est associé à la boutique depuis le Back Office Marchand.
  • S'il est valorisé dans le champ paymentMethods, champ facultatif (Voir Sélectionner les moyens de paiement).

Si vous utilisez un moyen de paiement non disponible, un message d'avertissement apparaît dans la console du navigateur.

Utilisez cette fonction KR.getPaymentMethods() pour connaître les moyens de paiement disponibles.

Règle d'affichage

Par défaut, les moyens de paiement compatibles s'affichent selon l'ordre de priorité des contrats associés à la boutique. Cet ordre se paramètre depuis le Back Office Marchand.

Le paiement par cartes

Si le paiement par carte est disponible, il apparaît toujours en première position.

Exemple

* Le paiement par cartes est absent du tableau.

// function
smartForm.userPaymentMethodsOrder = ['PAYPAL', 'APPLE_PAY']
// result
Result = ['CARDS', 'PAYPAL', 'APPLE_PAY']
  • Le paiement par cartes n'est pas en première position dans l'ordre d'affichage.
// function
smartForm.userPaymentMethodsOrder = ['PAYPAL', 'APPLE_PAY']

// result
Result = ['CARDS', 'PAYPAL', 'APPLE_PAY']

Les autres moyens de paiement

Si les autres moyens de paiement sont disponibles et non listés dans le tableau, ils apparaîssent en dernière position.

Exemple

  • Pour PayPal
// your shop
SHOP = ['CARDS', 'PAYPAL', 'APPLE_PAY' ]

// function without APPLE_PAY
smartForm.userPaymentMethodsOrder = ['CARDS', 'APPLE_PAY']

// result
Result = ['CARDS', 'APPLE_PAY', 'PAYPAL']

Exemple d'intégration

Vous devez implémenter la méthode dans le headerde votre page de paiement, après le chargement de la librairie JavaScript (kr-payment-form.min.js), ainsi que les feuilles de styles associées.

KR.setFormConfig({
  smartForm:
  { userPaymentMethodsOrder: ['PAYPAL', 'APPLE_PAY', 'CARDS'] }
  }
  );
© 2025 Tous droits réservés à SystempayMentions légales
25.18-1.11