Vous devez vous rapprocher de votre r=
esponsable de compte partenaire Cofidis pour obtenir les informations n=C3=
=A9cessaires permettant de configurer votre compte sur Payline (login du co=
mpte et mot de passe).
Ensuite vous pouvez param=C3=A9trer vous-m=C3=AAme votre nouveau moyen de p=
aiement en homologation.
Vous devez r=C3=A9aliser des transactions tests pour valider le bon fo=
nctionnement en production.
Payline se charge de se connecter =C3=A0 l=E2=80=99interface Cofidis afi=
n que l=E2=80=99acheteur puisse ex=C3=A9cuter son paiement, et que les fond=
s soient revers=C3=A9s au commer=C3=A7ant.
Bancaire<=
/h3>
Vous avez souscrit un compte commer=C3=A7ant 1EURO.COM aupr=C3=A8s de Co=
fidis.
Cette =C3=A9tape vous permet de cr=C3=A9er un compte 1EURO.COM chez Cofi=
dis. Cette d=C3=A9marche est r=C3=A9alisation en ligne via le site http://www.cofidis-retail.fr/. Suivez les instructions qui vous y sont=
donn=C3=A9es.
A la fin du processus d=E2=80=99inscription, vous devez disposer de =
;:
- votre identifiant commer=C3=A7ant 1EURO.COM. Il permet votre identifica=
tion lors des =C3=A9changes entre Payline et 1EURO.COM. Celui-ci vous sera =
demand=C3=A9 lors de votre cr=C3=A9ation de contrat 1EURO.COM sur Payline (=
=C3=A9tape 2) ;
- Un certificat de s=C3=A9curit=C3=A9 pour la connexion =C3=A0 l=E2=80=99=
API de 1EURO.COM. Ce certificat doit =C3=A9galement =C3=AAtre communiqu=C3=
=A9 =C3=A0 Payline.
Commercial
Vous avez d=C3=A9clar=C3=A9 votre soci=C3=A9t=C3=A9 au registre du comme=
rce, poss=C3=A9dez un n=C2=B0 de SIRET et une adresse email valide.
Vous avez souscrit au produit Payline avec l=E2=80=99option 1EURO.COM
Payline
Afin de cr=C3=A9er un contrat 1EURO.COM sur Payline, en homologation et =
en production, rendez-vous sur le centre d=E2=80=99administration dans l=E2=
=80=99onglet =C2=AB Configuration =C2=BB puis =C2=AB Vos moy=
ens de paiement =C2=BB. Un =C3=A9cran de recherche s=E2=80=99affiche, =
cliquez sur le bouton =C2=AB Nouveau moyen de paiement =C2=BB.
Ecran de cr=C3=A9ation de moyen d=
e paiement 1/2:
S=C3=A9lectionnez votre point de vente pu=
is le type de moyen de paiement 1EURO.COM comme ci-dessous.
Cliquez ensuite sur le bouton =C2=AB =
;Suivant =C2=BB.
Ecran de cr=C3=A9ation de moyen d=
e paiement 2/2:
Renseigner un libell=C3=A9, un num=C3=A9r=
o de contrat de votre choix puis s=C3=A9lectionner votre devise. Cliquez su=
r le statut =C2=AB Actif =C2=BB et renseigner la valeur du champ&=
nbsp;R=C3=A9f=C3=A9rence Commer=C3=A7ant chez Cofidis 1euro.com. Il s=
=E2=80=99agit d=E2=80=99un compte de test utilisable uniquement dans l=E2=
=80=99environnement d=E2=80=99homologation donn=C3=A9 par Cofidis.
Le cod=
e (card_code) du moyen de paiement est : 1EURO.COM
Une fois le moyen de paiement activ=C3=A9, il vous suffit d'utiliser l'A=
PI Webpayment et les fonctions doWebPayment() et getWebPaymentDetails() ave=
c une version 8 ou sup=C3=A9rieure.
Les API DirectPayment, Ajax, Batch et TPEV ne sont pas disponibles.
Les fonctionnalit=C3=A9s de paiement disponibles sont :
- Paiement =C3=A0 la commande : Renseignez le =
champ payment.mode =C3=A0 CPT et payment.action =C3=A0 101.
- Paiement =C3=A0 l'exp=C3=A9dition : Renseign=
ez le champ payment.mode =C3=A0 CPT et payment.action =C3=A0 100.
- Demande d'encaissement diff=C3=A9r=C3=A9 : Utilisez la=
fonction doCapture() de l'API WebService.
- Demande d'annulation d'une autorisation non encaiss=C3=A9e : Utilisez la fonction doReset() de l'API WebService.=
li>
- Demande de remboursement : Utilisez la fonct=
ion doRefund() de l'API WebService avec le code payment.action =C3=A0 =
421.
L=E2=80=99appel de l=E2=80=99interface de paiement web se fait via notre=
web service doWebPayment. Le r=C3=A9sultat d=E2=80=99un paiement web est c=
onnu en appelant notre web service getWebPaymentDetails :
Le web service doWebPayment
La fonction =C2=AB doWebPayment =C2=BB permet d=E2=80=99initia=
liser une transaction de paiement web avant de rediriger votre client sur l=
es pages de paiement Payline.
Le paiement 1EURO.COM se fait exclusivement en paiement imm=C3=A9diat. P=
our cela, renseignez les champs =C2=AB payment.Action =C2=BB avec=
le code action, =C2=AB payment.Mode =C2=BB =C3=A0 CPT et =C2=AB&=
nbsp;payment.ContractNumber =C2=BB avec le num=C3=A9ro de votre contra=
t 1EURO.COM dans Payline.
Payline r=C3=A9alise une demande d=E2=80=99autorisation aupr=C3=A8s de C=
ofidis et dans le cas d=E2=80=99un accord, valide automatiquement le paieme=
nt.
Le web service getWebPaymentdetails
Pour r=C3=A9aliser une demande de r=C3=A9sultat de la transaction de pai=
ement, Payline met =C3=A0 votre disposition ce web service. Vous devez =
;transmettre le jeton d=E2=80=99authentification (token) d=C3=A9livr=C3=A9 =
par Payline lors de la demande d=E2=80=99initialisation (r=C3=A9sultat de l=
a fonction doWebPayment) pour obtenir un r=C3=A9sultat d=C3=A9taill=C3=A9 d=
u paiement.
Note : Les autres fonctions de l'API ne sont pas disponibles pour ce moy=
en de paiement : annulation partielle ou multiple, d=C3=A9bit, cr=C3=A9dit,=
paiement en n fois ou r=C3=A9current.
Les champs ob=
ligatoires
Liste des c=
hamps..
Le tableau ci-dessous donne la liste des informations d=
ossier que peut fournir Payline s=E2=80=99ils sont donn=C3=A9s par le comme=
r=C3=A7ant..
Buyer.title |
Civilit=C3=A9 MR / MME / MLLE |
|
|
=
|
Buyer.lastName |
Nom du client |
|
|
=
|
Buyer.firstName |
Pr=C3=A9nom du client |
|
|
=
|
Buyer.billingAddress.street1 |
Adresse de facturation |
|
|
=
|
Buyer.billingAddress.street2 |
Compl=C3=A9ment d=E2=80=99adresse<=
/td>
|
|
|
=
|
Buyer.billingAddress.zipCode |
Code postal ville de l=E2=80=99adr=
esse |
|
|
=
|
Buyer.billingAddress.cityName =
; |
ville de l=E2=80=99adresse |
|
|
=
|
Buyer.mobilePhone |
Num=C3=A9ro de t=C3=A9l=C3=A9phone=
mobile |
|
|
=
|
payment.amount |
Montant de l'op=C3=A9ration |
|
=
|
|
payment.currency |
Code iso de la devise |
|
=
|
|
buyer.billingAddress.lastname |
Nom de la personne pour la factura=
tion |
|
=
|
|
buyer.billingAddress.firstname |
Pr=C3=A9nom de la personne pour la=
facturation |
|
=
|
|
buyer.billingAddress.street1 |
Adresse pour la facturation |
|
=
|
|
buyer.billingAdress.street2 |
Adresse pour la facturation |
|
=
|
|
buyer.billingAddress.zipcode |
Adresse pour la facturation |
|
=
|
|
buyer.billingAddress.cityName=
p> |
Adresse pour la facturation |
|
=
|
|
buyer.billingAddress.country |
Adresse pour la facturation |
|
=
|
|
buyer.shippingAdress.lastname |
Nom de la personne pour la livrais=
on |
|
=
|
|
buyer.shippingAdress.firstname |
Pr=C3=A9nom de la personne pour la=
livraison |
|
=
|
|
buyer.shippingAdress.street1 |
Adresse pour la livraison |
|
=
|
|
buyer.shippingAdress.street2 |
Adresse pour la livraison |
|
=
|
|
buyer.shippingAdress.zipcode |
Adresse pour la livraison |
|
=
|
|
buyer.shippingAdress.cityName |
Adresse pour la livraison |
|
=
|
|
buyer.shippingAdress.country |
Adresse pour la livraison |
|
=
|
|
buyer.email |
Adresse =C3=A9lectronique de l'ach=
eteur |
|
|
|
buyer.birthDate |
Date de naissance de l'acheteur
| format date : AAAAMMJJ |
=
|
|
miscData |
Cl=C3=A9 : "preScore", valeur :=
7 digits |
La r=C3=A8gle de construction du <=
strong>prescore est =C3=A0 d=C3=A9finir entre le commer=C3=A7ant e=
t Cofidis |
=
|
|
order.ref |
R=C3=A9f=C3=A9rence de la commande=
|
|
=
|
|
order.orderExtended.riskLevel |
Code indiquant le niveau de risque=
de la commande |
|
=
|
|
order.deliveryCharge |
Montant de la livraison |
Montant en plus petite unit=C3=A9 |
=
|
|
order.discountAmount<=
/td>
| Montant de la promotion |
|
=
|
|
order.deliveryMode |
Mode de retrait |
Cf. Values for deliveryMode |
=
|
|
order.orderExtended.delivery=
Provider |
Nom du service de livraison |
|
=
|
|
order.deliveryTime |
Type de livraison |
Cf.&=
nbsp;Values for deliveryTi=
me |
|
|
subMerchant.subMerchantSIRET |
SIRET du sous-marchand |
|
=
|
|
subMerchant.subMerchantName |
Nom du sous-marchand |
|
=
|
|
orderDetail.ref |
R=C3=A9f=C3=A9rence de l''article |
|
=
|
|
orderDetail.quantity |
Nombre d'articles |
|
=
|
|
orderDetail.price |
Prix des articles |
|
=
|
|
orderDetail.category |
Cat=C3=A9gorie d'article |
Nomenclature Payline (cf. Code=
s - Category) ou description libre |
=
|
|
orderDetail.comment |
Commentaire |
|
=
|
|
orderDetail.subcategory1 |
Rang 1 sous cat=C3=A9gorie |
|
=
|
|
orderDetail.brand |
La marque du produit |
|
=
|
|
orderDetail.subcategory2 |
Rang 2 sous cat=C3=A9gorie |
|
=
|
|
orderDetail.additionalData |
Donn=C3=A9e "risk" au format JSO=
N Liste des sp=C3=A9cifications "risque" requises pour =
le moyen de paiement |
0 :=
Non risqu=C3=A9 1 : Risqu=C3=A9 |
=
|
|
orderDetail.additionalData |
Donn=C3=A9e "status" au format J=
SON Liste des sp=C3=A9cifications "statuts" requises po=
ur le moyen de paiement |
1 :=
Neuf 2 : Reconditionn=C3=A9 3 : Occasion 4 : A=
utre |
=
|
|
orderDetail.additionalData |
Donn=C3=A9e "discount" au format=
JSON |
0 :=
Pas de promotion 1 : Promotion |
=
|
|
orderDetail.seller |
Nom ou identifiant du vendeur fina=
l |
|
=
|
|
orderDetail.sellerType |
Type de vendeur |
2 :=
private seller 1 : professional |
=
|
|
media |
Canal d'achat utilis=C3=A9 |
1 : Undefined 2 : Computer <=
p style=3D"text-align: left;">3 : Mobile4 : Tablette=
5 : TV<=
/p> 6 : Co=
nsole |
=
|
|
buyer.ip |
Adresse IP de l'acheteur |
|
=
|
|
buyerExtendedHistory.orderCount6Months |
Nombre de commandes pass=C3=A9es p=
ar l'acheteur au cours des six derniers mois |
|
=
|
|
buyerExtendedHistory.orderAmount6Months |
Montant total des commandes pass=
=C3=A9es au cours des six derniers mois |
|
=
|
|
buyer.accountOrderCount |
Le nombre de commandes pass=C3=A9e=
s par l'acheteur |
|
=
|
|
buyer.accountAverageAmount |
Panier moyen de l'acheteur <=
/td>
|
|
=
|
|
buyer.accountCreateDate |
Date de cr=C3=A9ation du compte de=
l'acheteur |
For=
mat : dd/mm/yy |
=
|
|
buyerExtendedHistory.firstOrderDate |
Date de la premi=C3=A8re commande<=
/td>
| Sto=
ck=C3=A9 par Payline en JSON : D=
D/MM/YYYY hh:mm:ss |
=
|
|
buyerExtendedHistory.lastOrderDate |
Date de la derni=C3=A8re commande<=
/td>
| Sto=
ck=C3=A9 par Payline en JSON : D=
D/MM/YYYY hh:mm:ss |
=
|
|
buyer.customerId |
Identifiant de l'acheteur |
|
=
|
|
buyer.legalStatus |
Type d'acheteur |
1 :=
Person 2 : Business |
=
|
|
buyer.legalDocument |
Num=C3=A9ro d'identification du do=
cument officiel |
|
=
|
|
ord=
er.orderOTA.transport.legList.segment ord=
er.orderOTA.transport.legList.departur=
eDate order.orderOTA.carRental.pickUpDate order.orderOTA.accomodation.checkInDate |
Type de Leg Date de d=C3=
=A9part Date de ramassage Date d'arriv=C3=A9e Champs au fo=
rmat JSON. |
Par=
ordre de priorit=C3=A9 d=C3=A9croissante bas=C3=A9 sur le premier passager=
: order.orderOTA.transport.legList=
.departureDate
(Where order.orderOTA.transpo=
rt.legList.segment =3D O)
OU order.orderOTA.carRental=
.pickUpDate OU =
span>order.orderOTA.accomodation=
.checkInDate Stock=C3=A9 pa=
r Payline en JSON (Contr=C3=B4ler le format =C3=A0 l'export) |
=
|
|
ord=
er.orderOTA.transport.legList.segment ord=
er.orderOTA.transport.legList.arrivalD=
ate order.orderOTA.carRental.return=
Date order.orderOTA.a=
ccomodation.checkOutDate=
|
Type de Leg Date d'arriv=
=C3=A9e Date de retour Date de d=C3=A9part Champs au forma=
t JSON. |
Par ordre de priorit=C3=A9 d=C3=
=A9croissante bas=C3=A9 sur le premier passager : order.orderOTA.transport.legList.arrivalDate (Where order=
.orderOTA.transport.legList.segment =3D R)
OU order.orderOTA.carRental.returnDate OU order.orderOTA.accomodatio=
n.checkOutDate Stock=C3=A9 par Payline en JSON (Contr=C3=B4ler le=
format =C3=A0 l'export) |
=
|
|
order.OTAPackageType |
Type d'offre d'h=C3=A9bergement=
Champs au format JSON. |
99 : Not specified or Other 1 : Journey only 2 : Journey + accomodation 3 : Accomodation only |
=
|
|
order.orderOTA.countryDestination |
Nom du pays de destination <=
p>Champs au format JSON. |
|
=
|
|
order.orderOTA.travelPurpose |
L'objet du voyage Champs a=
u format JSON. |
2 : Business 1 : Leisure 0 : Not Sp=
ecified or special |
=
|
|
order.orderOTA.transport.legList.segment |
Type de segment Cham=
ps au format JSON. |
Nombre de order.orderOTA.transport.legList.segment de type Tn |
=
|
|
Il vous faut obtenir un compte de tes=
t aupr=C3=A8s de Cofidis.
Les donn=C3=A9es de tests vous seront=
communiqu=C3=A9es par Cofidis avec votre compte de tests.
Validez votre int=C3=A9gration
Cette =C3=A9tape vous permet de contr=C3=B4ler que votre int=C3=A9gratio=
n est correcte :
- R=C3=A9alisez un paiement complet avec votre contrat Payline 1EURO.COM.=
- Consultez le centre d=E2=80=99administration commer=C3=A7ant et validez=
le bon enregistrement de vos transactions de paiement.
Les codes de retour<=
br>
Monext Online vous informe du r=C3=
=A9sultat d=E2=80=99un paiement via le ShortMessage, selon le mode d'int=C3=
=A9gration propos=C3=A9 par le moyen de paiement.
Les =C3=A9tats retourn=C3=A9s : =
span>
- Le paiement est accept=C3=A9 avec=
l'=C3=A9tat ACCEPTED et le code retour 00000.
- Le paiement est refus=C3=A9 avec =
l'=C3=A9tat REFUSED. Le code varie en fonction du motif de refus (Par exemp=
le : 01xxx pour une raison bancaire ou 04xxx pour une suspicion de fraude).=
La gestion des =C3=A9tats et des c=
odes retour sont list=C3=A9s ici.<=
/span>