• France
état des services
démonstrations
assistance
FAQContacter le support
Video tutorials
Rechercher
Catégories
Tags
Français
Français
Anglais
Accueil
Cas d'usage
Créer un paiement
Créer un paiement en plusieurs fois
Proposer un paiement complémentaire
Créer un paiement par alias (token)
Créer un lien de paiement
Créer un paiement à l'expédition
Créer un abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
Intégration mobile
Échange de fichiers
Exemples de code
Moyens de paiement
Modules de paiement
Guides
Back Office Marchand
Guides fonctionnels

Etape 3 : Créer un formToken

Objectif

  • Générer un formToken.

Le formToken est une clé générée par la plateforme. Il définit le contexte de paiement (montant, devise, numéro de commande, coordonnées de l'acheteur, etc.).

Le formToken est le **résultat de la réponse** de l'appel Web Service REST Charge/CreatePayment.

Il est valide pendant 15 minutes. Cette durée est fixe et non modifiable pour des raisons techniques.

I. Requête pour un paiement simple

Exemple :

  • montant : 9,90 €.
  • commande : "myOrderId-999999",
  • email de l'acheteur : "sample@example.com".
/doc/fr-FR/rest/V4.0/api/kb/authentication.html
https://github.com/lyra/rest-php-examples/blob/master/www/minimalEmbeddedForm.php#L9-L44
https://api.scelliuspaiement.labanquepostale.fr/api-payment/V4/Charge/CreatePayment
{
    "amount":   990,
    "currency": "EUR",
    "orderId":  "myOrderId-999999",
    "customer": {
        "email": "sample@example.com"
    }
}
{
    "amount":   1500,
    "currency": "PEN",
    "orderId":  "myOrderId-999999",
    "more": "parameters",
    "customer": {
        "email": "sample@example.com"
    }
}
{
    "amount":   20000,
    "currency": "ARS",
    "orderId":  "myOrderId-999999",
    "more": "parameters",
    "customer": {
        "email": "sample@example.com"
    }
}
{
    "amount":   100000,
    "currency": "COP",
    "orderId":  "myOrderId-999999",
    "more": "parameters",
    "customer": {
        "email": "sample@example.com"
    }
}
{
    "amount":   2500,
    "currency": "BRL",
    "orderId":  "myOrderId-999999",
    "more": "parameters",
    "customer": {
        "email": "sample@example.com"
    }
}

II. Réponse pour un paiement simple

{
    "status": "SUCCESS",
    "_type": "V4/WebService/Response",
    "webService": "Charge/CreatePayment",
    "applicationProvider": "LBP",
    "version": "V4",
    "applicationVersion": "4.1.0",
    "answer": {
        "formToken": "DEMO-TOKEN-TO-BE-REPLACED",
        "_type": "V4/Charge/PaymentForm"
    }
}

Le formToken généré est Processing...

III. Autres cas d'utilisation

  • Sélectionner les moyens de paiement

  • Proposer l'enregistrement du moyen de paiement.

  • Augmenter les chances de frictionless en 3DS2

  • Transmettre des données personnalisées

D'autres exemples sont disponibles sur cette page : Cas d'utilisation.

IV. Utilisation du Playground

Utilisez le Playground Charge/CreatePayment pour connaître l'intégralité des champs disponibles.

Cliquez sur le bouton "Testez-moi", créez votre requête puis exécutez l'appel REST pour générer le formToken.

V. Exemple simplifié PHP

Dans le dossier sample, le fichier de cette étape est formToken.php.

Pour plus de détails, Fichier d'exemple : formToken.php

ETAPE SUIVANTE N°4

© 2025 Tous droits réservés à Scellius
25.18-1.11