Carte cadeau Oney - Intégration

S’abonner




Comment configurer votre compte ?


Vous devez vous rapprocher de votre responsable de compte Carte Cadeau Oney/Banque Accord pour obtenir les informations nécessaires permettant de configurer votre compte sur Payline.
Ensuite veuillez adresser un email à notre équipe support@payline.com avec les informations, afin qu'ils puissent procéder au paramétrage dans votre compte marchand Payline en indiquant l’ID Marchand et le nom du contrat partenaire à créer.
Vous devez réaliser des transactions 'pilote' pour valider le bon fonctionnement en production.

Votre demande à notre équipe support devra être accompagnée de ces éléments :

  • Votre numero de contrat Oney ;
  • Votre contrat VAD CB pour les paiements complémentaires.

Une fois votre compte créé dans PAYLINE, vous obtiendrez un nom de l'alias, nécessaire à l'utilisation du moyen de paiement dans Payline.



Comment proposer le paiement Carte Cadeau Oney à vos clients ?

Les principes d’utilisation

Une fois le moyen de paiement activé, il est utilisable au travers des fonctions standard Payline en indiquant le contrat du moyen de paiement Contrat_Number. 
Le mode d'intégration est disponible avec l'API WebPayment  : services doWebPayment et getWebPaymentDetails
Le mode d'intégration avec l'API DirectPayment avec le service  doAuthorization.

Les web services en mode Web

  • Interfaces de paiement : API WebPayment et API DirecPayment

  • Paiement à la commande : en utilisant le service  doWebPayment  avec payment.mode à CPT et code Action à 101.

  • Paiement à l'expédition : en utilisant les services doWebPayment  et doCapture avec le code Mode à CPT et code Action à 100.
  • Mode de paiement : comptant, différé, récurrent, n fois  avec le code Mode = CPT, DIF.
  • Paiement en différé : en utilisant les services doAuthorization et doCapture avec le code Mode à DIF et le code Action à 100.
  • Demande d'annulation d'une autorisation non encaissée : utilisez la fonction doReset permet au marchand de demander l’annulation totale ou partielle de la commande.
  • Demande de remboursement d'une transaction remisée : utilisez la fonction doRefund pour rembourser la commande.

Le paiement complémentaire carte bancaire

Le paiement complémentaire est disponible dès qu'il y a un reste à payer. Le montant minimum est de 0,01 €.

Le remboursement

Le remboursement par le web service « doRefund » est disponible. Il se réalise en priorité sur la carte bancaire

  • Exemple 1 : Commande de 100 € payée en 20 € par carte cadeau et 80 € par paiement CB, pour un remboursement de 50 € le client sera remboursé uniquement sur sa carte bancaire.
  • Exemple 2 : Pour la même commande, si le remboursement est de 90 €, le client sera remboursé de 80 € sur sa CB et 10 € sur sa carte carte cadeau.

Les annulations par le web service « doReset » sont possibles.

Les champs obligatoires

Les paiement à la commande ou à l'expédition

Le paiement nécessite les paramètres suivants :

  • Payment mode = CPT ou DIF
  • Payment fonction = Autor+Capture  ou Autor ou Capture
  • Payment action = 101  ou 100
  • Version = 9
  • Les informations sur le mode de livraison de la commande sont obligatoires :
    • Mode de livraison à remplir uniquement avec les valeurs données en annexe pour ce champ : order.deliveryMode
    • Type de livraison à remplir uniquement avec les valeurs données en annexe pour ce champ : order.deliveryTime
  • L'adresse de livraison de l'acheteur n'est pas obligatoire (l'objet « buyer.shippingAddress » peut être absent de votre appel à Payline).

Néanmoins, si vous utilisez cette balise « buyer.shippingAddress », vous devez remplir ces champs :

  • Civilité de la personne récupérant la commande.

Si le mode de livraison choisi est 4 alors le champ civilité de société est nécessaire : buyer.shippingAddress.title

  • Prénom

Si le mode de livraison choisi est 4 alors le champ prénom est requis : buyer.shippingAddress.firstname

  • Nom

Si le mode de livraison choisi est 4 alors le champ nom est requis : buyer.shippingAddress.lastname

  • Rue : buyer.shippingAddress.street1
  • Code postal : buyer.shippingAddress.zipCode
  • Ville : buyer.shippingAddress.cityName
  • Pays : buyer.shippingAddress.country

L'adresse de facturation de l'acheteur n'est pas requise.

Cependant, si vous utilisez l'objet « buyer.billingAddress », vous devez nécessairement remplir ces champs :

  • Civilité à remplir uniquement avec les valeurs données en annexe pour ce champ : buyer.billingAddress.title
  • Prénom : buyer.billingAddress.firstName
  • Nom : buyer.billingAddress.lastName 
  • Rue : buyer.billingAddress. billingAddress.street 
  • Code postal : buyer.billingAddress. billingAddress.zipCode 
  • Ville : buyer.billingAddress. billingAddress.cityName 
  • Pays : buyer.billingAddress. billingAddress.country

Le détail de chaque article contenu dans le panier n'est pas obligatoire.

Néanmoins, si vous utilisez l'objet « order.details », il vous faut renseigner ces éléments :

  • Référence de l'article : details.ref
  • Commentaire : details.comment
  • Prix : details.price
  • Quantité : details.quantity
  • Catégorie de l'article à remplir uniquement avec les valeurs données en annexe pour ce champ : details.category
  • Marque de l'article : details.brand

Liste des valeurs


Champ title

Code Payline

Libellé court

Libellé long

1

Mme

Madame

2

Mmes

Mesdames

3

Mlle

Mademoiselle

4

M.

Monsieur

5

MM.

Messieurs

6

Vve

Veuve

7

Dr

Docteur

8

Drs

Docteurs

9

Pr

Professeurs

10

Me

Maître

11

Mes

Maîtres

12

Mgr

Monseigneur

Champ Delivery_mode

Code Payline

Libellé court

1

StorePickup

2

NetworkPickup

3

TravelPickup

4

Carrier

5

eDelivery.

Champ Delivery_time

Code Payline

Libellé court

1

Express

2

Standard

Champ Category

Code Payline

Libellé court

1

Informatique (matériel et logiciel)

2

Electronique

3

Téléphone

4

Electroménager

5

Habitat et jardin

6

Mode

7

Produit de beauté

8

bijouterie

9

Sport

10

Loisirs

11

Automobiles / motos

12

Ameublement

13

Enfants

14

Jeux video

15

Jouets

16

Animaux

17

Alimentation

18

Cadeaux

19

Spectacles

20

Voyages

21

Enchères

22

Services aux particuliers

23

Services aux professionnels


Les codes de retour

Avec l'API WebPayment, Payline vous informe du résultat d'un paiement via Shortmessage des services : getWebPaymentDetails et getTransactionDetails.
Avec l'API DirectPayment, Payline vous informe du résultat de manière synchrone en réponse du doAuthorization
Lorsque le paiement est accepté, Payline renvoie le code retour à la valeur  00000.
Pour un paiement refusé, le code varie en fonction du motif de refus (Par exemple : 04xxx pour une suspicion de fraude).

Les codes spécifiques au moyen de paiement sont listés ici.



Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0
Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk