Oney Bank Card
Introduction
Notre plateforme propose deux variantes de cette méthode de paiement : Oney Card et Oney Branded Card.
Alors que le processus d'inscription pour Oney Card est plus rapide, Oney Branded Card vous permet de personnaliser à la fois les cartes et la page de paiement Oney selon votre identité d'entreprise.
Par conséquent, plusieurs paymentProductId existent. Trouvez toutes les valeurs possibles dans le chapitre d'intégration. L'intégration décrite ci-dessous reste la même pour les deux variantes.
La carte Oney est une solution de crédit à la consommation proposée par Oney.
La carte Oney permet un haut niveau de personnalisation des conditions de paiement, de la carte émise et de la page de paiement. Cela s'applique à la fois à vous et à vos clients, par exemple en proposant :
- Promotions spéciales, remises, programmes de cashback et de fidélité.
- Options de paiement disponibles (y compris crédit, paiements en plusieurs fois ou options de paiement différé).
L'intégration est très simple, car vous n'avez besoin que d'envoyer quelques paramètres supplémentaires avec votre demande. Vous redirigez vos clients vers la page de paiement Oney où ils saisissent leurs données de carte Oney.
Activation
Pour utiliser Oney dans notre environnement de test/production, suivez ces étapes :
- Signez un contrat avec Oney et recevez en retour les identifiants d'activation.
- Transmettez nous les identifiants (MID/mot de passe et éventuellement d'autres identifiants) .
- Nous procédons à la vérification nécessaire à l'intégration.
- Nous activons la méthode de paiement dans votre compte.
France
Intégration
Redirigez vos clients vers la page de paiement Oney via notre Hosted Checkout Page. Retrouvez 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":"M.",
"firstName":"Dupont",
"surname":"Jean"
}
},
"contactDetails":{
"emailAddress":"jean.dupont@test.com"
}
}
},
"hostedCheckoutSpecificInput":{
"locale":"fr_FR"
},
"redirectPaymentMethodSpecificInput":{
"paymentProductId":5127,
"requiresApproval":true,
"returnUrl":"https://yourReturnUrl.com",
"paymentOption":"xx"
}
}| Propriété | Remarques |
|---|---|
|
order.amountOfMoney |
amount : Le montant brut que vous souhaitez facturer pour cette commande. currencyCode : Le code de la devise ISO 4217 pour ce montant. |
|
customer.personalInformation |
Les informations personnelles de votre client |
| order.customer.contactDetails.emailAddress | L'adresse e-mail de votre client |
|
hostedCheckoutSpecificInput.locale |
La version linguistique de notre Hosted Checkout Page |
|
redirectPaymentMethodSpecificInput |
paymentProductId : L'identifiant numérique de la méthode de paiement sur notre plateforme. Trouvez cet identifiant dans la liste ci-dessous. Il indique à notre plateforme d'envoyer directement vos clients à la page de paiement 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. requiresApproval: Réglez sur "false", car ce mode de paiement ne permet que le mode Direct Sale. returnUrl : L'URL à laquelle nous redirigeons vos clients après la finalisation du paiement.paymentOption : Indique le nombre de versements dans lesquels la transaction est divisée. Vous définissez avec Oney lors de votre intégration les modalités disponibles et la plage de valeurs. Si non envoyé, vos clients pourront choisir la modalité souhaitée sur la page de paiement Oney. |
Retrouvez des informations détaillées sur cet objet et ses propriétés dans notre documentation CreateHostedCheckoutAPI.
Liste des marques de cartes Oney disponibles
| Marque | paymentProductId |
|---|---|
| Carte Oney | 5127 |
|
Carte de marque Oney |
5128 |
Cinématique
- Vos clients finalisent une commande dans votre boutique et choisissent la carte Oney.
- Vous envoyez cette demande CreateHostedCheckout vers notre plateforme.
- Vous redirigez vos clients via la redirectUrl vers le portail Thunes. Ils confirment la commande avec leurs données de carte, leurs données personnelles et leurs modalités de paiement préférées.
- Nous recevons le résultat de la transaction.
- Nous redirigeons votre client vers votre returnUrl.
- Vous demandez le résultat de la transaction de notre plateforme via GetHostedCheckout ou recevez le résultat via des 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.