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 :

Créez un alias
- Soit vous utilisez le Web Service Rest Charge/CreatePayment.
  Vous valorisez le paramètre formAction à REGISTER_PAY ou ASK_REGISTER_PAY.
- Soit vous utilisez le Web Service Rest Charge/CreateToken.
Créez l'abonnement en utilisant l'alias généré avec le Web Service Charge/CreateSubscription.

Catégories

Tags