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 |
Ce paramètre est mappé dans l’objet transactions[0].creationDate
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.
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
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
Ce champ à plusieurs équivalents, en fonction du contexte. Pour plus d’informations, consulter Cycle de vie d’une transaction.
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 n’a pas d’équivalent. L’id de transaction est généré automatiquement par les web services REST
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.
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.
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