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 une authentification avec interaction de l'acheteur est demandé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.

L'échéancier est ensuite présenté à l'acheteur sur les pages de paiement.

La première échéance fonctionne de la même manière qu'un paiement comptant immédiat. Le résultat est notifié au site marchand grâce à la règle URL de notification à la fin du paiement.

Les échéances suivantes s'apparentent à des paiements comptants différés.

Précisions :

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.

Le jour du paiement, le marchand n’est pas crédité de la totalité du montant et le transfert de responsabilité ne peut s’appliquer sur les échéances futures.

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é.

Utilisez l'ensemble des champs présents ci-dessous 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	Ex : CB pour appeler le bouton de paiement CB.
vads_site_id	Identifiant de la boutique	n8	Ex : 12345678
vads_ctx_mode	Mode de communication avec la plateforme de paiement	enum	`TEST` ou`PRODUCTION`
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). Attention : ce champ n'est pas sensible à la casse.	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 unité monétaire	n..12	Ex : 4525 pour 4525 XPF
vads_currency	Code numérique de la monnaie à utiliser pour le paiement, selon la norme ISO 4217 (code numérique)	n3	Ex : 953 pour le Franc CFP (XPF)
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_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

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 unité 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 unité de la devise. La somme de tous les montants doit être égale à la valeur du champ vads_amount.
  
  Les dates sont exprimées au format YYYYMMDD.
Valorisez le champ vads_capture_delay à 0. Le 1er paiement sera remis en banque le jour même.
Valorisez le champ vads_validation_mode à 0 pour une validation automatique (le paiement sera remis de manière automatique à la banque) ou à 1 pour une validation manuelle (opération manuelle effectuée depuis le Back Office Marchand).
Le mode de validation s'applique à toutes les échéances.
Ajoutez les champs optionnels en fonction de vos besoins (voir chapitre Utiliser des fonctions complémentaires du Guide d'implémentation API Formulaire).
Calculez la valeur du champ signature en utilisant l’ensemble des champs de votre formulaire, dont le nom commence par vads_ (voir : Calculer la signature du Guide d'implémentation API Formulaire disponible sur notre site documentaire).

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

<form method="POST" action="https://secure.osb.pf/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="953" />
<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éances personnalisés) :

<form method="POST" action="https://secure.osb.pf/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="953" />
<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>

Catégories

Tags

Créer un paiement en plusieurs fois