• France
lyra.com
Rechercher
Catégories
Tags
France
France
Espagne
Europe (Anglais)
Inde
Implémentation
Formulaire embarqué (cartes)
API REST
API REST PCI-DSS
API REST SEPA
Formulaire en redirection
Échange de fichiers
Paiement mobile
Exemples de code
Modules de paiement
Marketplace
Back Office
Back Office Marchand
Back Office Expert
Guides
Aide
FAQ
Tutoriels vidéos
Support

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 à 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 navigateur 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. A ce jour, seul deux options sont disponibles :

  • PAYMENT
  • REGISTER_PAY

Vous pouvez simuler l'option REGISTER en créant une transaction à un euro en validation manuelle. Pour plus de détails, rendez vous ici : paiement en un clic.

Les options ASK_REGISTER_PAY et REGISTER_UPDATE sont planifiés pour le début de l'année 2019.

Quel est l'équivalent de vads_identifier ?

il faut utiliser la paramètre paymentMethodToken du 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

Nous recrutons

Head Office :

LYRA NETWORK
109, rue de l’innovation
31670 Labège
FRANCE

2.8.1-doc-1.8