Comment proposer Oney à vos clients ?

Une fois le moyen de paiement activé, il vous suffit d'utiliser l'API Webpayment et les fonctions doWebPayment et getWebPaymentDetails.
Les API DirectPayment, Ajax, Batch et TPEV ne sont pas disponibles.

Les fonctionnalités de paiement disponibles sont :

1. débit à la commande
2. débit à l'expédition

Les autres fonctions de l'API ne sont pas disponibles pour ce moyen de paiement.
Les informations adresses de facturation, données de livraison et contenu du panier sont obligatoires.

Débit à la commande

Suite à une demande de paiement, Oney peut directement donner son accord, refuser directement le financement ou étudier le dossier de votre client. Cette analyse peut prendre jusqu'à 3 jours consécutifs à la demande de paiement (1,1 jours en moyenne).
Durant ce temps d'étude, votre transaction peut prendre le statut « ONHOLD_PARTNER » avec le code retour « 02016 ».
Si Oney a directement donné son accord, votre transaction prendra directement le statut final accepté « 00000 ».

Une fois qu'Oney a étudié le dossier client, Monext est directement informé et votre transaction change de statut pour un statut final accepté « 00000 » ou refusé « 04xxx ». Une notification WEB vous informe du changement de statut de votre transaction.
Votre paiement et le débit de votre client interviennent automatiquement suite à cette deuxième étape ou directement à la première étape si Oney a répondu favorablement.

Il vous faut renseigner obligatoirement les paramètres suivants dans votre appel web service pour réaliser un paiement :

• Payment mode = CPT
• Payment action = 101

Voir le détail des informations obligatoires en bas de page.

Débit à l'expédition

Suite à une demande de paiement, Oney peut directement donner son accord ou étudier le dossier de votre client. Cette analyse peut prendre jusqu'à 3 jours consécutifs à la demande de paiement.
Durant ce temps d'étude, votre transaction peut prendre le statut « in progress » avec les codes retours « 02000 » et « 02005». Si Oney a directement donné son accord, votre transaction prendra directement le statut final accepté « 00000 ».

Vous réalisez une demande de paiement de type « autorisation » via le web service  doWebpayment . Pour cela, il vous faut remplir ces éléments obligatoires dans l'appel web service :

• Payment mode = CPT
• Payment action = 100

Voir le détail des informations obligatoires en bas de page.

Quand Oney a donné son accord, votre transaction change de statut pour un statut final accepté « 00000 » ou refusé « 04xxx ». Une notification WEB Monext Online vous informe du changement de statut de votre transaction.
Vous pouvez alors réalisr un appel au web service doCapture pour procéder au débit de la carte du consommateur.

La validation

Sur Monext Online, cette opération peut se faire :

• par le web service doCapture ;
• par le centre administration Monext Online ;
• par validation automatique (batch).

Le remboursement

Vous pouvez réaliser un remboursement partiel ou total d'un paiement Oney.

Attention, le remboursement partiel peut se faire uniquement dans les 90 jours qui suivent le paiement initial. Au-delà de ce délai, le remboursement partiel ne pourra pas être réalisé, un email est alors envoyé au marchand (à l'adresse fournie lors de l'intégration).

Après validation d'une commande avec un financement accepté, il faut observer un délai de 48h glissantes avant de pouvoir réaliser une annulation/remboursement.

Pour effectuer un remboursement, vous pouvez utiliser :

• le web service doRefund ;
• le centre d'administration Monext Online.
  
  

Marketplace

Le commerçant peut indiquer un sous commerçant lors d'une intégration en marketplace, en utilisant la balise subMerchant pour une transaction. Si la commande se compose de plusieurs sous-marchand, vous devez indiquer celui qui représente la part la plus importante de votre commande.

État En Attente

Ce moyen de paiement propose de générer des commandes avec un temps de validation. Votre commande sera en attente avec l'état ONHOLD_PARTNER, il permet de connaitre l'état réel du virement.
Il est recommandé de gérer cet état et d'indiquer l'état de la commande à votre acheteur.
Vous pouvez consulter la description de la gestion des états et des codes retour.

Les données de tests

Un jeu de test (carte et données consommateur) vous sera fourni par Oney, ainsi qu'un cahier de recette. Vous devrez utiliser ces données pour effectuer votre recette sur notre environnement d'Homologation.

Oney impose un phase de certification : vous devez prendre contatc avec votr responsable de compte Oney afin de définir les modalités de cette étape.

Cette certification est nécessaire pour obtenir les informations permettant de configurer le compte en production.

Afficher les pages de paiement

L'affichage de la page de paiement nécessite simplement de contacter le service web doWebPayment.

L'affichage du moyen de paiement Oney se réalise tout simplement en cochant la case à cocher « activer ce moyen de paiement » dans l'écran de configuration du centre d'administration Monext Online.

Certains commerçants utilisent la fonction de sélection des moyens de paiement à afficher au consommateur. Si cela est votre cas, vous devez ajouter à la valeur du champ  selectedContractNumber  le numéro que vous avez renseigné lors de la configuration du moyen de paiement (Plus d'information dans le chapitre Création du moyen de paiement.

Enfin, dans le cas où vous souhaitez afficher directement le formulaire de souscription d'Oney, vous devez renseigner le champ  contractNumber  que vous avez renseigné lors de la configuration du moyen de paiement

Quel est le reporting disponible ?

Monext enregistre une transaction intégrant le paiement par carte Oney.
Les transactions sont transmises dans les fichiers  Liste des transactions et Liste des paiements.

Le fichier « Liste des transactions » peut être :

• Soit généré manuellement via le centre d'administration. Dans le menu Transactions de paiement, cliquez sur Exporter vos transactions.
• Soit généré en automatique quotidiennement et envoyé par un flux sécurisé.

Les codes de retour

Lorsque le paiement est accepté, Monext Online renvoie le code retour à la valeur « 00000 » ou « 02000 » selon l'avancée de l'étude menée par Oney sur la demande de paiement de votre client. Pour un paiement refusé, le code varie en fonction du motif de refus (Par exemple : « 04xxx » pour une suspicion de fraude).  

Spécificités sur les champs des web services pour ce moyen de paiement

* pour toutes les échéances 3x,4x, credit et BNPL.

Spécificités sur order.details