Créer une demande de paiement
- Utilisez l'ensemble des champs présents
dans le tableau ci-après pour construire votre formulaire de paiement.
Nom du champ Description Format Valeur vads_payment_cards Permet de forcer le type de carte à utiliser. Il est recommandé de proposer sur le site marchand un bouton de paiement différent pour chaque moyen de paiement.
Il est déconseillé de laisser le champ vide.
enum PRESTO pour appeler directement le bouton de paiement Presto. vads_order_id Numéro de la commande Peut être composé de majuscules ou de minuscules, chiffres ou tiret ([A-Z] [a-z], 0-9, _, -).
ans..64 Ex: CDE-fr-04_2020 vads_page_action Action à réaliser enum PAYMENT vads_ctx_mode Mode de communication avec la plateforme de paiement enum TEST ouPRODUCTION vads_amount Montant du paiement en centimes d'euro. La valeur doit être comprise entre 150€ et 16000€. n..12 Ex : 30000 pour 300,00€ vads_currency Code numérique de la monnaie euro, selon la norme ISO 4217 (code numérique) n3 Valeur possible: - 978 (EUR)
vads_action_mode Mode d’acquisition des données du moyen de paiement enum INTERACTIVE vads_payment_config Type de paiement enum SINGLE vads_cust_email Adresse e-mail de l'acheteur ans..49 Ex : abc@example.com vads_cust_first_name Prénom Caractères acceptés :
- A-Z, a-z
- à, â, é, è, ê, ë, ï, î, ô, ù, ü, ç
- apostrophe, tiret, espace
ans..30 Ex : Laurent vads_cust_last_name Nom Caractères acceptés :
- A-Z, a-z
- à, â, é, è, ê, ë, ï, î, ô, ù, ü, ç
- apostrophe, tiret, espace
ans..30 Ex : Durant vads_cust_address Numéro et nom de rue Caractères acceptés :
- A-Z, a-z, 0-9
- à, â, é, è, ê, ë, î, ï, ô, ù, ü, ç, ä, ö, û
- apostrophe, tiret, virgule, espace, point
ans..32 Ex : 109 rue de l'innovation vads_cust_zip Code postal n5 Ex : 31500 vads_cust_city Ville Caractères acceptés :
- A-Z, a-z, 0-9
- à, â, é, è, ê, ë, ï, î, ô, ù, ü, ç
- apostrophe, tiret, espace
ans..30 Ex : Labège vads_cust_country Code pays suivant la norme ISO 3166 alpha-2. Ce moyen de paiement n'est disponible que pour les clients résidents en France.
a2 FR vads_cust_phone Téléphone domicile n10 Ex : 0123456789 vads_cust_cell_phone Téléphone mobile n10 Ex : 0612345678 vads_site_id Identifiant de la boutique n8 Ex : 12345678 vads_trans_date Date et heure du formulaire de paiement dans le fuseau horaire UTC n14 Respectez le format AAAAMMJJHHMMSS
Ex : 20200101130025vads_trans_id Numéro de la transaction. Attention : ce champ n'est pas sensible à la casse.
an6 Ex : xrT15p vads_version Version du protocole d’échange avec la plateforme de paiement enum V2 - Utilisez les champs ci-dessous pour définir le contenu du panier. Sans
description du panier, le moyen de paiement PRESTO ne sera pas proposé.
Nom du champ Description Format Valeur vads_nb_products Nombre d’articles présents dans le panier n..12 Ex : 2 vads_product_labelN Libellé de l’article. N correspond à l'indice de l'article (0 pour le premier, 1 pour le second...). ans..255 Ex : vads_product_label0 = "Séjour 3 jours datés"
vads_product_label1 = "Concert privé"
vads_product_amountN Montant de l’article exprimé dans la plus petite unité de la devise. N correspond à l'indice de l'article (0 pour le premier, 1 pour le second...). n..12 Ex : vads_product_amount0 = "32150"
vads_product_amount1 = "10700"
vads_product_typeN Type de l’article. N correspond à l'indice de l'article (0 pour le premier, 1 pour le second...). enum Valeurs possibles : voir étape suivante. vads_product_refN Référence de l’article. N correspond à l'indice de l'article (0 pour le premier, 1 pour le second...). an..64 Ex : vads_product_ref0 = "1002127784"
vads_product_ref1 = "1002127693"
vads_product_qtyN Quantité d’article. N correspond à l'indice de l'article (0 pour le premier, 1 pour le second...). n..12 Ex : vads_product_qty0 = "1"
vads_product_qty1 = "1"
- Valorisez le champ vads_product_typeN avec la valeur correspondant au
type de l'article. N correspond à l'indice de l'article (0 pour le premier, 1
pour le second...). Si le panier contient des articles de plusieurs types, seul le type de l'article le plus cher sera pris en compte.Seules les valeurs en gras dans le tableau ci-dessous permettent de payer avec PRESTO.
Valeur Description FOOD_AND_GROCERY Produits alimentaires et d'épicerie AUTOMOTIVE Automobile / Moto ENTERTAINMENT Divertissement / Culture HOME_AND_GARDEN Maison et jardin HOME_APPLIANCE Equipement de la maison AUCTION_AND_GROUP_BUYING Ventes aux enchères et achats groupés FLOWERS_AND_GIFTS Fleurs et cadeaux COMPUTER_AND_SOFTWARE Ordinateurs et logiciels HEALTH_AND_BEAUTY Santé et beauté SERVICE_FOR_INDIVIDUAL Services à la personne SERVICE_FOR_BUSINESS Services aux entreprises SPORTS Sports CLOTHING_AND_ACCESSORIES Vêtements et accessoires TRAVEL Voyage HOME_AUDIO_PHOTO_VIDEO Son, image et vidéo TELEPHONY Téléphonie - Calculez la valeur du champ signature en utilisant l’ensemble des champs de votre formulaire, dont le nom commence par vads_ (voir chapitre Calculer la signature du Guide d'implémentation API Formulaire disponible sur notre site documentaire).