• France
état des services
démonstrations
assistance
FAQContacter le support
Video tutorials
Rechercher
Catégories
Tags
Français
Français
Anglais
Accueil
Cas d'usage
Créer un paiement
Créer un paiement en plusieurs fois
Proposer un paiement complémentaire
Créer un paiement par alias (token)
Créer un lien de paiement
Créer un paiement à l'expédition
Créer un abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
Intégration mobile
Échange de fichiers
Exemples de code
Moyens de paiement
Modules de paiement
Guides
Back Office Marchand
Guides fonctionnels

Créer un paiement en plusieurs fois

Dans le cadre de l'application de la DSP2, une authentification forte est requise lors du paiement de la première échéance. Le champ vads_threeds_mpi est ignoré et la valeur CHALLENGE_MANDATE est appliquée automatiquement.

Ce mode de paiement permet au marchand de proposer une facilité de paiement à l’acheteur.

Le formulaire de paiement définit le nombre d’échéances et l’intervalle qui les sépare.

La première échéance fonctionne de la même manière qu'un paiement comptant immédiat.

La ou les échéances suivantes s'apparentent à un ou des paiements comptant différés.

Des règles de notifications doivent être activées selon l'échéance. Référez-vous au chapitre Paramétrer les notifications pour plus de détails.

Le champ vads_amount contient le montant total de la commande. C'est ce montant qui sera scindé selon la valeur du champ vads_payment_config.

La date de la dernière échéance ne peut être supérieure à 1 an par rapport à la date de soumission du formulaire. Dans le cas contraire, un message d’erreur est affiché et le formulaire rejeté.

  1. Utilisez l'ensemble des champs présents ci-dessous pour construire votre formulaire de paiement.
    Nom du champ Description Format Valeur
    vads_site_id Identifiant de la boutique n8 Ex : 12345678
    vads_ctx_mode Mode de communication avec la plateforme de paiement enum TEST ouPRODUCTION
    vads_trans_id Numéro de la transaction.

    Doit être unique sur une même journée (de 00:00:00 UTC à 23:59:59 UTC).

    an6 Ex : xrT15p
    vads_trans_date Date et heure du formulaire de paiement dans le fuseau horaire UTC. n14

    Respectez le format AAAAMMJJHHMMSS

    Ex : 20200101130025
    vads_amount Montant du paiement dans sa plus petite fraction monétaire (le centime pour l'euro). n..12 Ex : 4525 pour 45,25 EUR
    vads_currency Code numérique de la monnaie à utiliser pour le paiement, selon la norme ISO 4217 (code numérique). n3 Ex : 978 pour l'euro (EUR)
    vads_action_mode Mode d’acquisition des données du moyen de paiement enum INTERACTIVE
    vads_page_action Action à réaliser enum PAYMENT
    vads_version Version du protocole d’échange avec la plateforme de paiement enum V2
    vads_payment_config Type de paiement enum

    voir étape 2.

    vads_payment_cards Permet de forcer le type de carte à utiliser.

    Affichez un bouton de paiement distinct pour chaque moyen de paiement disponible sur le site marchand.

    Il est déconseillé de laisser le champ vide.

    Consultez le chapitre Gérer les moyens de paiement proposés à l'acheteur pour plus d'informations.

    enum Ex :
    • CB
    • MASTERCARD
    • VISA
    vads_capture_delay Délai avant remise en banque. n..3
    vads_validation_mode Précise le mode de validation de la transaction (manuellement par le marchand, ou automatiquement par la plateforme) n1 0 ou 1 ou absent ou vide
    signature Signature garantissant l'intégrité des requêtes échangées entre le site marchand et la plateforme de paiement. ans..44 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).
  2. Valorisez le champ vads_payment_config en respectant la syntaxe suivante:
    • Montants et dates d'échéances fixes :

      MULTI:first=1000;count=3;period=30 où :

      "first" correspond au montant (dans la plus petite fraction de la devise) du premier paiement réalisé le jour du paiement,
      "count" représente le nombre total d'échéances,
      "period" détermine l'intervalle entre chaque échéance.
    • Montants et dates d'échéance personnalisés :

      MULTI_EXT:date1=montant1;date2=montant2;date3=montant3 où :

      date1=montant1 définit la date et le montant du premier versement.
      Les montants sont exprimés dans la plus petite fraction de la devise. La somme dees montants doit être égale à la valeur du champ vads_amount.
      Les dates sont exprimées au format YYYYMMDD.
  3. Valorisez le champ vads_capture_delay à 0 pour que le paiement soit remis en banque le jour même.
  4. Valorisez le champ vads_validation_mode :
    • À 0 pour une validation automatique (le paiement sera automatiquement remis en banque).
    • À 1 pour une validation manuelle (opération effectuée depuis le Back Office Marchand).
    Le mode de validation s'applique à toutes les échéances.
  5. Valorisez le champ vads_currency avec le code de la devise souhaitée en utilisant le tableau des devises.
  6. Ajoutez les champs recommandés pour augmenter les chances de frictionless lors du paiement.
  7. Ajoutez les champs optionnels en fonction de vos besoins (voir chapitre "Utiliser des fonctions complémentaires".

Exemple de formulaire de paiement en plusieurs fois (montants et dates d'échéance fixes) :

<form method="POST" action="https://scelliuspaiement.labanquepostale.fr/vads-payment/">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_amount" value="3000" />
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_currency" value="978" />
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_config" value="MULTI:first=1000;count=3;period=30"/>
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20190629180150" />
<input type="hidden" name="vads_trans_id" value="1N015m" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value= "zrhUNkAciZSEl6mS4BbhV3qkYUBB9RYJQCdg1kU0ELU="/>
<input type="submit" name="payer" value="Payer" />
</form>

Exemple de formulaire de paiement en plusieurs fois (montants et dates d'échéance personnalisées) :

):

<form method="POST" action="https://scelliuspaiement.labanquepostale.fr/vads-payment/">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_amount" value="3000" />
<input type="hidden" name="vads_capture_delay" value="0" />
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_currency" value="" />
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_config" value=" 
MULTI_EXT:20140201=1000;20140301=1000;20140401=1000" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20190629130025" />
<input type="hidden" name="vads_trans_id" value="130025" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="7Sds6Z+R1Q1axRsblpChyQh5OU3oCle5FOirD4V/Bzk="/>
<input type="submit" name="payer" value="Payer"/>
</form>
© 2025 Tous droits réservés à Scellius
25.18-1.11