Oney

Introduction

Oney est une solution de paiement en plusieurs fois proposée par l'acquéreur français Oney.

Vos clients peuvent utiliser Oney pour diviser un paiement en plusieurs mensualités. En tant que commerçant, vous recevrez immédiatement le montant total de la commande. Oney assumera l'intégralité de la responsabilité des mensualités et de la relation avec l'acheteur en votre nom.

L'intégration est très facile, car vous n'avez besoin d'envoyer que quelques paramètres supplémentaires avec votre demande.

Proposez cette méthode de paiement dans une liste de pays européens en constante expansion !

Optimisé pour Desktop Tablet Mobile

Aperçu

Groupe de paiement :

Échéance

Identifiant du moyen de paiement:

5148

Avantages clés

Exigences PCI faibles
Intégration facile
Paiement garanti
Les remboursements sont possibles (partiels/multiples/intégraux)

Activation

Pour utiliser Oney dans notre environnement de test ou en production, suivez ces étapes :

Signer un contrat avec Oney et recevoir les identifiants d'activation en retour.
Se connecter au Merchant Portal de Worldline.
Naviguer vers Business -> Méthodes de paiement.
Utiliser les identifiants reçus pour activer Oney.

Pays & devises

Pays pris en charge

Belgique
France
Allemagne
Hongrie
Italie
Pologne
Portugal
Roumanie
Espagne

Devises prises en charge

Euro (EUR)
Hungarian forint (HUF)
Romanian new leu (RON)

Intégration

Redirigez vos clients vers le portail de paiement Oney via notre Hosted Checkout Page. Trouvez une vue d'ensemble dans le chapitre "Cinématique".

Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout :

{
  "order": {
    "amountOfMoney": {
      "currencyCode": "EUR",
      "amount": 170000
    },
    "customer": {
      "personalInformation": {
        "name": {
          "title": "Mr.",
          "firstName": "Dupont",
          "surname": "Jean"
        },
        "gender": "male",
        "dateOfBirth": "19490917"
      },
      "billingAddress": {
        "street": "bd de Rochechouart",
        "houseNumber": "13",
        "zip": "75009",
        "city": "Paris",
        "state": "Paris",
        "countryCode": "FR"
      },
      "shippingAddress": {
        "street": "bd de Rochechouart",
        "houseNumber": "13",
        "zip": "75009",
        "city": "Paris",
        "state": "Paris",
        "countryCode": "FR"
      },
      "contactDetails": {
        "emailAddress": "jean.dupont@test.com",
        "phoneNumber": "+330175757575"
      }
    },
    "references": {
      "merchantReference": "merchant-reference"
    },
    "shoppingCart": {
      "items": [
        {
          "amountOfMoney": {
            "currencyCode": "EUR",
            "amount": 170000
          },
          "orderLineDetails": {
            "productName": "ACME12",
            "discountAmount": 0,
            "lineAmountTotal": 170000,
            "productCode": "ASO45",
            "productPrice": 170000,
            "productType": "Fashion",
            "quantity": 1,
            "taxAmount": 0,
            "unit": "piece"
          }
        }
      ]
    }
  },
  "hostedCheckoutSpecificInput": {
    "locale": "fr_FR"
  },
  "redirectPaymentMethodSpecificInput": {
    "requiresApproval": true,
    "paymentProductId": 5148,
    "paymentOption": "PROVIDED FOR YOUR MERCHANT ID BY ONEY"
  }
}

Propriétés	Remarques
order.customer merchantCustomerId personalInformation companyInformation languageCode billingAddress shippingAddress contactDetails vatNumber	Si vous n'envoyez pas shippingAddress, vos clients devront fournir ces données sur le portail Oney.
references merchantOrderId merchantReference invoiceData descriptor	-
typeInformation.purchaseType	-
hostedCheckoutSpecificInput.locale	-
redirectPaymentMethodSpecificInput requiresApproval paymentProductId paymentOption	requiresApproval : Réglez sur "false", car ce mode de paiement ne permet que le mode Direct Sale. paymentProductId : L'identifiant numérique de la méthode de paiement sur notre plateforme. Trouvez cet id dans le chapitre "Aperçu". Il indique à notre plateforme d'envoyer vos clients directement sur le portail Oney. En cas d'omission, notre plateforme redirige vos clients vers la Hosted Checkout Page, leur permettant de choisir ce mode de paiement ou tout autre actif dans votre compte. paymentOption : contient une valeur indiquant que la transaction est divisée en 3 ou 4 versements. Les valeurs sont définies par vous et Oney.

L'option PaymentOption est une valeur fournie par Oney. Elle définit une redirection spécifique vers les méthodes de paiement 3x ou 4x.

Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.

Contactez Oney pour définir une limite de montant minimum/maximum par transaction.

Liste des marques Oney disponibles

Marque	paymentProductId
Oney	5148
Oney 3x	5146
Oney 4x	5147

Cinématique

Vos clients finalisent une commande dans votre boutique et sélectionnent Oney.
Vous envoyez cette demande CreateHostedCheckout à notre plateforme.
Vous redirigez vos clients via l'URL redirectUrl vers le portail Oney. Ils confirment la commande avec leurs données personnelles.
Nous recevons le résultat de la transaction.
Nous redirigeons votre client vers votre URL returnUrl
Vous demandez le résultat de la transaction de notre plateforme via GetHostedCheckout ou vous recevez le résultat via webhooks.
Si la transaction a réussi, vous pouvez livrer les marchandises/services.

Test

Consultez nos Cas de test pour des données de test et des instructions détaillées.

Assurez-vous d'utiliser le bon endpoint et de renseigner l'URL de production dès que vous avez terminé vos tests.
Les données dans notre chapitre Cas de test fonctionnent UNIQUEMENT pour les demandes de paiement dans notre environnement de test. Utiliser ces données dans notre environnement de production entraînera des résultats de test indésirables.