• France
status page
Merchant Back Office
assistance
FAQContact support
Search
Categories
Tags
English
French
English
Homepage
Use cases
Create a payment
Create an installment payment
Create a multi-card (split) payment
Create a payment by Alias (Token)
Create a payment link
Create a recurring payment
Manage subscriptions
Manage your transactions (refund, cancel...)
Analyze your reports
API docs
Embedded Form
REST API
Hosted payment
Mobile payment
File exchange
Logos
Push mail
Snippets
Payment methods
Plugins
Guides
Merchant Back Office
Functional guides

Create a token without payment.

API documentation: Charge/CreateToken

Only payment cards are supported. This method does not allow you to create a token from an IBAN.

Request

Sample query

Required fields:

  • currency: EUR.
  • buyer's email: "sample@example.com ".

. Recommended fields:

  • Référence de la commande : "myOrderId-1234".
  • Référence de l'acheteur : "myCustomerRef-123456".
/doc/en/rest/V4.0/api/kb/authentication.html
https://github.com/lyra/rest-php-examples/blob/master/www/minimalEmbeddedForm.php#L9-L44
https://api.systempay.fr/api-payment/V4/Charge/CreateToken
        {
          "currency": "EUR",
          "customer": {
            "email": "sample@example.com",
            "reference": "myCustomerRef-123456"
          },
          "orderId": "myOrderId-1234"
        }

To view the fields and their description, go to the playground: Charge/CreateToken (menu on left).

Response

Récupèrez le formToken pour afficher le formulaire de paiement (Plus d'infos : Afficher le formulaire).

A la fin du paiement, une transaction de type VERIFICATION sera créée. L'alias sera retourné dans transactions[0].paymentMethodToken (Plus d'infos : Analyser le résultat du paiement).

Example of a response
  {
    "shopId": "123456",,
    "orderCycle": "CLOSED",
    "orderStatus": "PAID",
    (...)
      "_type": "V4/OrderDetails"
    },
(...)
    },
    "transactions": [
      {
       "shopId": "123456",
       "uuid": "46a7484af36344e2bf7445915ded1606",
       "amount": 0,
       "currency": "EUR",
       "paymentMethodType": "CARD",
       "paymentMethodToken": "5a8e308dfdd948c1adfed79d0bcf0b41",
       "status": "PAID",
       "detailedStatus": "ACCEPTED",
       "operationType": "VERIFICATION",
       (...)
    "_type": "V4/Payment"
  }

Dans cet exemple, l'alias (champ paymentMethodToken) a pour valeur : "5a8e308dfdd948c1adfed79d0bcf0b41".

Pour connaître l'intégralité et la description des champs, consultez le playground : answer/Transaction.

© 2025 {'|'} All rights reserved to Systempaylegal
25.20-1.11