- Guide rapide -
Afficher une pop-in Oney
Utiliser les données d'une simulation de paiement Oney pour afficher une pop-in.
Cette fonctionnalité n'est disponible que si vous disposez de l'offre Premium.
Quel langage de programmation préférez-vous?
| PHP
| Python
|
Pour naviguer dans la présentation, appuyez sur les flèches directionnelles ou sur la touche espace de votre clavier.
Authentifiez-vous
L’authentification à l’API s’effectue en utilisant une clé secrète dans toutes les requêtes envoyées.
Pour utiliser la clé, ajoutez-là dans toutes vos pages utilisant l’API :
<?php
\Payplug\Payplug::init(array(
'secretKey' => 'sk_live_VOTRE_CLE_PRIVEE',
'apiVersion' => 'LA_VERSION_API',
));
payplug.set_secret_key('sk_live_VOTRE_CLE_PRIVEE')
Les clés à utiliser avec l’API commencent par “sk_”.
Elles sont disponibles dans le portail PayPlug en cliquant sur “Paramètres” puis sur “Clés API”.
Les modes TEST et LIVE utilisent le même endpoint, pour changer de mode à l’autre il suffit de changer la clé secrète.
Consultez le changelog pour savoir quelle version d’API utiliser.
La pop-in Oney
Les données utilisées pour afficher la pop-in Oney peuvent être récupérées via la route de simulation de paiement Oney.
La requête de simulation de paiement Oney
L’exemple suivant permet d’effectuer une requête de simulation de paiement Oney.
<?php
$simulations = \Payplug\OneySimulation::getSimulations(array(
'amount' => 17266,
'country' => 'FR',
'operations' => ['x3_with_fees', 'x4_with_fees']
));
data = {
'amount': 17266,
'country': 'FR',
'operations': ['x3_with_fees', 'x4_with_fees']
}
simulations = payplug.OneyPaymentSimulation.get_simulation(**data)
Les données de simulation de paiement Oney
Les données peuvent être utilisées pour afficher la pop-in.
{
"result": true,
"simulations": {
"x3_with_fees": {...},
"x4_with_fees": {
"installments": [
{
"date": "2021-01-22T01:00:00.000Z",
"amount": 4316
},
{
"date": "2021-02-22T01:00:00.000Z",
"amount": 4316
},
{
"date": "2021-03-22T01:00:00.000Z",
"amount": 4317
}
],
"total_cost": 380,
"nominal_annual_percentage_rate": 18.05,
"effective_annual_percentage_rate": 19.62,
"down_payment_amount": 4697
}
}
}
Associer les champs
Pop-in |
Data |
Pour un montant de |
amount envoyé en tant que donnée de la requête |
Premier apport |
down_payment_amount |
Coût du financement |
total_cost |
TAEG |
effective_annual_percentage_rate |
Mensualité n°1 |
installments[0]['amount'] |
Mensualité n°2 |
installments[1]['amount'] |
Mensualité n°3 |
installments[2]['amount'] |
Total |
down_payment_amount + installments[0]['amount'] + installments[1]['amount'] + installments[2]['amount'] |