• France
état des services
démonstrations
assistance
FAQContacter le support
Video tutorials
Rechercher
Catégories
Tags
docs.
France
Espagne
Europe (Anglais)
Inde
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 abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
SDK Mobile
Échange de fichiers
Mandats SEPA par API REST
Exemples de code
Moyens de paiement
Modules de paiement
Marketplace
Guides
Back Office Marchand
Back Office Expert
Guides fonctionnels

Migration du formulaire en redirection ou IFrame

Vous voulez migrer du formulaire en redirection (ou du formulaire en IFrame) vers le formulaire embarqué ? Cette page décrit les principaux paramètres et comment les utiliser avec le client JavaScript et l'API REST.

Redirection Description
vads_effective_creation_date Date effective de création de la transaction
vads_identifier Voir Charge/CreatePayment.paymentMethodToken
vads_identifier_status Statut du mandat SEPA: non supporté à ce jour
vads_language Définir la langue du formulaire de paiment
vads_page_action Voir Charge/CreatePayment.formAction
vads_payment_certificate Remplacé par un mécanisme de signature basé sur HMAC SHA256
vads_url_check_src Connaitre la source de la notification
vads_result Code de retour de l'opération. Correspond à divers champs dans l'API REST
vads_trans_id L'API REST définit automatiquement l'identifiant de transaction
vads_trans_date L'API REST définit automatiquement la date de transaction

vads_effective_creation_date

Ce paramètre est mappé dans l'objet transactions[0].creationDate

vads_identifier_status

Ce paramètre contient le statut du mandat SEPA. Ce paramètre n'a pas d'équivalent à ce jour, l'API REST ne supportant que les paiements par carte.

vads_language

Pour choisir la langue du formulaire de paiement, il faut définir la locale de votre choix lors du chargement du client javascript avec le paramètre kr-language.

Par exemple, pour afficher le formulaire en russe :

https://github.com/lyra/rest-php-examples/blob/master/www/minimalEmbeddedForm.ru-RU.php#L54-L59
  <script 
   src="<?php echo $client->getClientEndpoint();?>/static/js/krypton-client/V4.0/stable/kr-payment-form.min.js"
   kr-public-key="<?php echo $client->getPublicKey();?>"
   kr-language="ru-RU"
   kr-post-url-success="paid.php">
  </script>

Vous pouvez également définir la langue au runtime :

KR.setFormConfig({"language": "ru-RU"});

Pour plus d'informations, rendez-vous ici : Référence du client JavaScript

vads_url_check_src

Ce paramètre n'a pas d'équivalent dans l'API REST. Le paramètre qui s'en rapproche le plus est transactionDetails.cardDetails.paymentMethodSource.

Voir la documentation de référence pour plus de détails : objet Transaction

vads_result

Ce champ a plusieurs équivalents, en fonction du contexte. Pour plus d'informations, consulter Cycle de vie d'une transaction.

vads_payment_certificate

Le mécanisme de signature est maintenant basé sur HMAC SHA256.

Pour plus d'informations sur le fonctionnement de la signature, rendez-vous ici : retour à la boutique ou Utilisation de l'IPN (URL de notification)

vads_trans_date

vads_trans_date n'a pas d'équivalent. L'id de transaction est généré automatiquement par les web services REST

vads_trans_id

vads_trans_id n'a pas d'équivalent. L'id de transaction est généré automatiquement par les web services REST. L'identifiant n'est plus un nombre entier (integer) mais un UUID alphanumérique de 32 caractères.

vads_page_action

Il faut utiliser le paramètre formAction du Web Service REST Charge/CreatePayment :

  • PAYMENT : Création d'une transaction simple. Comportement par défaut.
  • REGISTER_PAY : Création d'un alias (token) du moyen de paiement en même temps de la transaction. Ne permet pas de créer un alias associé à un IBAN.
  • ASK_REGISTER_PAY : Ajoute une case à cocher sur le formulaire pour la création d'un alias (token). Ne permet pas de créer un alias associé à un IBAN.

Plus d'infos: Charge/CreatePayment.

Quel est l'équivalent de vads_identifier ?

Il faut utiliser la paramètre paymentMethodTokendu Web Service REST Charge/CreatePayment. Notez que l'API REST ne vous permet plus de définir vous-même l'identifiant de l'alias. Il est automatiquement généré par la plateforme sous la forme d'une chaine alphanumérique de 32 caratères de long.

Exemple d'alias: 4b92ad0a0bfe4dd0976a5954f8071b59

Quel est l' équivalent pour créer un abonnement ?

Vous devez procéder en 2 étapes.

  1. Créez un alias.
  • Soit vous utilisez le Web Service Rest Charge/CreatePayment.

    • REGISTER_PAY : avec le paramètre formAction.
    • ASK_REGISTER_PAY** : avec le paramètre formAction.
  • Soit vous utilisez le Web Service Rest Charge/CreateToken.

  1. Créez l'abonnement en utilisant l'alias généré (lien :Charge/CreateSubscription).
Nous recrutons
Mentions légales
Charte de Protection des Données Personnelles
25.18-1.11