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 :
<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
