Créer un paiement en plusieurs fois
Assurez-vous d' avoir intégré les chapitres suivants du guide Intégration
avancée :
- Le chapitre "Établir le dialogue avec la plateforme de paiement".
- Le chapitre "Calculer la signature".
Dans une requête POST vers l'URL de la page de paiement (https://sogecommerce.societegenerale.eu/vads-payment/), intégrez les données suivantes :
- Champs obligatoires
- Mode d’acquisition avec le champ vads_action_mode. Ex : INTERACTIVE.
- Montant exprimé dans la plus petite unité de la monnaie ou devise avec le champ vads_amount. Ex : Pour un montant de 100,00 EUR, valorisez 10000.
- Devise avec le champ vads_currency. Ex : 978 pour l'euro (EUR).
- Mode de communication avec le champ vads_ctx_mode. Ex : TEST.
- Action à réaliser avec le champ vads_page_action. Ex : PAYMENT.
- Création de l'échéancier avec le champ vads_payment_config :
- Montants et dates
d'échéances fixes :
- MULTI:first;count;period
- "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:
- date1=montant1 définit la date et le montant du premier versement,
- date2=montant2 définit la date et le montant du deuxième versement,
- date3=montant3 définit la date et le montant du troisième versement.
- Les montants sont exprimés dans la plus petite unité de la monnaie ou devise. La somme des montants doit être égale à la valeur du champ vads_amount. Les dates sont exprimées au format AAAAMMJJ.
- Montants et dates
d'échéances fixes :
- Identifiant de la boutique avec le champ vads_site_id. Ex :12345678.
- Numéro de la transaction avec le champ vads_trans_id. Ex : pt156G.
- Horodatage (AAAAMMJJHHMMSS) avec le champ vads_trans_date. Ex : 20250626101407.
- Numéro de version avec le champ vads_version. Ex : V2.
- Signature pour sécuriser les échanges. Ex : 0WaYrONo3L0VZqMcvyVf8vT/g8KfZKJ+1jqiAs3Ehiw=(voir : Calculer la signature du Guide d'implémentation API Formulaire disponible sur notre site documentaire)
- Champs recommandés
- Référence de la commande avec le champ vads_order_id. Ex : myOrderId-1234.
- E-mail de l'acheteur avec le champ vads_cust_email. Ex : sample@example.com.
- Exemple de code
- Règle avec le champ vads_payment_config avec des montants et
dates d'échéance fixes.
- Montant du premier paiement : 10,00 EUR.
- Nombre d’échéances : 3 pour du paiement en 3 fois.
- Période (en jours) entre chaque échéance : 30 jours.
<form method="POST" action="https://sogecommerce.societegenerale.eu/vads-payment/"> <input type="hidden" name="vads_action_mode" value="INTERACTIVE" /> <input type="hidden" name="vads_amount" value="10000" /> <input type="hidden" name="vads_ctx_m" value="TEST" /> <input type="hidden" name="vads_currency" value="978" /> <input type="hidden" name="vads_cust_email" value="sample@example.com" /> <input type="hidden" name="vads_order_id" value="myOrderId-1234" /> <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="20250626101407" /> <input type="hidden" name="vads_trans_id" value="pt156G" /> <input type="hidden" name="vads_version" value="V2" /> <input type="hidden" name="signature" value="0WaYrONo3L0VZqMcvyVf8vT/g8KfZKJ+1jqiAs3Ehiw="/> <input type="submit" name="payer" value="Payer"/> </form>
- Règle avec le champ vads_payment_config avec des montants et
dates d'échéance personnalisées :
- Montant du premier paiement : 50,00 EUR, le 01/01/2025.
- Montant du deuxième paiement : 25,00 EUR, le 01/02/2025.
- Montant du troisième paiement : 25,00 EUR, le 01/03/2025.
<form method="POST" action="https://sogecommerce.societegenerale.eu/vads-payment/"> <input type="hidden" name="vads_action_mode" value="INTERACTIVE" /> <input type="hidden" name="vads_amount" value="10000" /> <input type="hidden" name="vads_ctx_m" value="TEST" /> <input type="hidden" name="vads_currency" value="978" /> <input type="hidden" name="vads_cust_email" value="sample@example.com" /> <input type="hidden" name="vads_order_id" value="myOrderId-1234" /> <input type="hidden" name="vads_page_action" value="PAYMENT" /> <input type="hidden" name="vads_payment_config" value=" MULTI_EXT:20250101=5000;20250201=2500;20250301=2500" /> <input type="hidden" name="vads_site_id" value="12345678" /> <input type="hidden" name="vads_trans_date" value="20250626101407" /> <input type="hidden" name="vads_trans_id" value="pt156G" /> <input type="hidden" name="vads_version" value="V2" /> <input type="hidden" name="signature" value="0WaYrONo3L0VZqMcvyVf8vT/g8KfZKJ+1jqiAs3Ehiw="/> <input type="submit" name="payer" value="Payer"/> </form>
- Règle avec le champ vads_payment_config avec des montants et
dates d'échéance fixes.
Retrouvez la description et l'intégralité des champs vads_ dans le Dictionnaire des données .
Pour avoir plus de détails, voir le guide complet : API Formulaire.