Arborescence des pages

Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

...

Sommaire
maxLevel2
stylenone

 

...

 

Ancre
PW - Ajout d'un moyen de paiement

non géré par PaylineVous souhaitez proposer à vos clients

PW - Ajout d'un moyen de paiement

que vous gérez vous même, par exemple une carte de fidélité propre à votre enseigne.

L'attribut additionnel data-custompm que vous pouvez utiliser dans la balise <div> permet de personnaliser l'affichage du formulaire. Par exemple, si vous ne souhaitez pas que le formulaire de paiement s'affiche automatiquement lors de l'affichage de votre page :

Ajout d'un

ParamètreDescriptionExempledata-custompmLe nom de la fonction javascript qui va générer le formulaire du

moyen de paiement non géré par Payline

maFonctionJavascript

Cette fonction est appelée durant le processus d’initialisation du Widget, donc soit au onload du body, soit à l’appel de Payline.Api.init() si data-auto-init="false" a été spécifié.

La fonction doit retourner un tableau d’objet, chacun de ces objets représentant un moyen de paiement.
Dans chacun de ces objets, on doit retrouver les attributs obligatoires suivants :

  • paymentMethodId : chaine de caractère destinée à identifier le moyen de paiement. Cette chaine, après avoir subi un lowercase, sera utilisée concaténée dans des id HTML, et doit donc respecter les normes associées. Utile pour appliquer du CSS à votre
  • html : chaine de caractère qui sera injecté dans le formulaire. Libre à vous de réutiliser ou non la structure HTML et les classes CSS que nous utilisons pour les moyens de paiement gérés par l’API.

Un attribut facultatif index (type numérique) peut aussi être spécifié pour insérer votre moyen de paiement au sein de la liste qui a été donnée lors du doWebPayment. Si index est absent, le moyen de paiement sera rajouté à la fin de la liste de moyens de paiement existante.

Par exemple, la fonction JavaScript suivante va ajouter un moyen de paiement personnalisé dont le formulaire sera composé d'un input simple ainsi que d'un bouton.

Bloc de code
languagecss
themeEclipse
[id*="mycustompm"] span.pl-card-logo {
	background:none; width: auto;
}
[id*="mycustompm"] span.pl-card-logo::before {
	content:"Mon moyen de paiement";
}

 

Pour personnaliser le logo qui sera généré automatiquement par le script Payline, vous pouvez utiliser du CSS. Parce que le script Payline utilise le champ paymentMethodId de votre moyen de paiement personnalisé pour construire les identifiant HTML des éléments qui composeront votre moyen de paiement personnalisé, il est facile de cibler le logo avec des sélecteurs CSS tels que :

Bloc de code
languagecss
[id*="mycustompm"] span.pl-card-logo {
	background:none; width: auto;
}
[id*="mycustompm"] span.pl-card-logo::before {
	content:"Mon moyen de paiement";
}

 

Inclusion d'extrait
PW - Ajout d'un moyen de paiement non géré par Payline
PW - Ajout d'un moyen de paiement non géré par Payline
nopaneltrue


Ancre
PW - Modifier le montant
PW - Modifier le montant

Modifier le montant de la transaction entre l'initialisation et le paiement

Inclusion d'extrait
PW - Modifier
Vous souhaitez améliorer l'expérience utilisateur, nous vous conseillons d'initialiser le paiement (via la fonction doWebPayment) le plus tôt possible dans le tunnel d'achat. Si possible, dès l'étape du choix du mode de livraison. En effet, vous gagnerez beaucoup lors du temps d'affichage de l'étape paiement. Cette façon de faire implique de pouvoir modifier
le montant de la transaction
après l'initialisation du paiement.

 

La modification du montant pourra alors être réalisée par un appel HTTP contenant une trame en JSON avec les données qui viendront écraser ce qui a pu être spécifié dans le doWebPayment.
L’URL à appeler sera :

La requête HTTP devra utiliser la méthode PUT, et devra spécifier dans son header le Content-Type : application/json ; le corps de la requête, lui, devra contenir les données à modifier formatées en JSON.
La structure de l’objet JSON à envoyer est décrite par le tableau qui suit. Aucun attribut de cet objet JSON n’est obligatoire, sauf exception explicitée dans le tableau. Il est donc possible de n’envoyer qu’une partie de la structure à votre convenance.

Objets niveau 1

Objet niveau 2

Objet niveau 3

Objet niveau 4

payment

amount

  

currency

  

order

amount

  

currency

  

taxes

  

deliveryTime

  

deliveryMode

  

deliveryExpectedDate

  

deliveryExpectedDelay

  

details

orderDetail

ref

price (obligatoire à l’envoi d’un order detail)

quantity

comment

category

brand

subcategory1

subcategory2

additionalData

taxRate

orderDetail

ref

buyer

shippingAddress

title

 name 

lastName

 

firstName

 

street1

 

street2

 

cityName

 

zipCode

 

country

 

phone

 

state

 

county

 

phoneType

 

billingAddress

title

 

name

 

lastName

 

firstName

 

street1

 

street2

 

cityName

 

zipCode

 

country

 

phone

 

state

 

county

 

phoneType

 
Avertissement

Il est nécessaire de contrôler systématiquement le montant pris en compte pour la transaction.

Ce montant est disponible dans le champ payment.amount de la réponse à la fonction getWebPaymentDetails(). 

 Par mesure de sécurité, cette fonction n'est pas activé par défaut. Si vous souhaitez l'activer, il vous faut cocher l'option dans l'écran de configuration de votre point de vente.

Liste des navigateurs compatibles

Le tableau ci-dessous liste les navigateurs qui sont compatibles avec les modes Lightbox et Intégré. Si un navigateur avec une version inférieure est détectée, le mode redirection est automatiquement utilisé pour afficher la page de paiement au consommateur.

NavigateurVersion
Chrome>=28
Chrome Mobile>=28
Firefox>=31
Firefox Mobile>=31
Internet Explorer>=9
Internet Explorer Mobile>=9
Safari>=6
Safari Mobile>=6
Opera>=24
Opera Mobile>=22
Android Browser>=4

Liste des moyens de paiement disponibles

Le tableau ci-dessous liste les moyens de paiements disponibles avec les modes Lightbox et Intégré. Tous les autres moyens de paiement sont disponibles avec le mode Redirection

CBCarte Bancaire, Visa, Mastercard MCVISAVisa, Mastercard AMEXAmerican Expresspaiement comptant et en N foisAMEX RECAmerican Express Smartbill 1EURO.COM1EURO.COM 3xCB3xCB Cofidis 3xONEY3xCB Oney BCMCBancontact MistercardCartes co-brandée Maestro et cartes domestiquesELVELV GIROPAYGiropay IDEALIDEAL MAESTROMaestro MASTERPASSMasterpassun problème est identifié sur ce moyen de paiementPAYLIBPaylib PAYPALPayPal POSTFINANCEPostfinance SOFORTSofort JCBJCBsans le dispositif JSecureCA_DO_CARTECadoCarte CDGPCDGP Cofinoga COFINOGACofinoga CYRILLUSCarte Cyrillus Finaref DINERSDiners DISCOVERDiscover FNACCarte FNAC Finaref ILLICADOILLICADO KANGOUROUCarte Kangourou Finaref KLARNAKLARNA invoice LEETCHILEETCHI LYDIALYDIA MONEYCLICMoneyclic NEOSURFNeosurf NETELLERNeteller P24Przelewy 24 PAYSAFECARDPaysafecard PRINTEMPSCarte Printemps Finaref SDDSDDvia SlimpaySPIRIT_OF_CADEAUSpirit of Cadeau TICKETSURFTicketSurf TOTAL GRCarte Total GR YANDEXYandex wallet SWITCHSWITCH BOLETOBOLETO BANCARIO 

PW - Modifier le montant de la transaction
nopaneltrue

Ancre
PW - Liste des navigateurs compatibles
PW - Liste des navigateurs compatibles

Liste des navigateurs compatibles

Inclusion d'extrait
PW - Liste des navigateurs compatibles
PW - Liste des navigateurs compatibles
nopaneltrue

 

 

Ancre
PW - Liste des moyens de paiement
PW - Liste des moyens de paiement

Liste des moyens de paiement disponibles

Inclusion d'extrait
PW - Liste des moyens de paiement disponibles
PW - Liste des moyens de paiement disponibles
nopaneltrue