NAV Navbar
Logo

- 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.

Installez la librairie

1- Téléchargez la librairie sur GitHub :

github.com/payplug/payplug-php

github.com/payplug/payplug-python

2- Ajoutez dans toutes vos pages utilisant l’API :

<?php
require_once('PATH_TO_PAYPLUG/payplug_php/lib/init.php');
import payplug

Authentifiez-vous

L’authentification à l’API s’effectue en utilisant une clé API 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' => 'eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIxMjM0NTYifQ.c2lnbmF0dXJl',
  'apiVersion' => 'LA_VERSION_API',
));
payplug.set_secret_key('eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIxMjM0NTYifQ.c2lnbmF0dXJl')

Les anciennes clés secrètes, qui commencent par “sk_”, sont obsolètes : elles fonctionnent encore, mais d’ici quelques mois elles ne permettront plus de vous authentifier.
Les clés API 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 de clé.

Consultez le changelog pour savoir quelle version d’API utiliser.

La pop-in Oney

Oney pop-in

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']

Liens et ressources


[ Retourner au début de la présentation ]