1. Home
  2. Solutions d'intégration
  3. Paiements récurrents
  4. Scheduled Payments

Scheduled Payments

Les paiements échelonnés permettent aux clients de payer pour un achat en plusieurs versements, plutôt qu'en une seule fois. Cette option s'utilise généralement pour les montants importants, de sorte que le client n'ait pas à dépenser une trop grosse somme en une seule fois pour une commande. C'est le commerçant qui se charge intégralement du calcul de l'échelonnement et du montant.

1. Paramètres supplémentaires

Pour indiquer que vous souhaitez régler une nouvelle transaction en plusieurs versements, vous devez présenter des paramètres supplémentaires.

Les champs cachés suivants sont utilisés pour transmettre les paiements échelonnés à notre système (en mode Page de paiement hebergée et DirectLink):

Champ

 Description
AMOUNT Le montant total à payer (MULTIPLIÉ PAR 100, vu que le format du montant ne peut pas contenir de décimales ou d'autres séparateurs).
AMOUNT1 Le montant à payer le jour de la transaction initiale (MULTIPLIÉ PAR 100).
AMOUNT2 Le montant du deuxième paiement (MULTIPLIÉ PAR 100).
Ce champ peut être répété N fois, en changeant le nombre à la fin du nom du champ (AMOUNT3, AMOUNT4, etc.).
EXECUTIONDATE2 La date d'exécution du deuxième paiement.
Format : dd/MM/yyyy (jj/MM/aaaa)
Ce champ peut être répété N fois, en modifiant le nombre à la fin du nom de champ (EXECUTIONDATE3, EXECUTIONDATE4, etc.).
(...)
AMOUNTN Le montant du dernier paiement.
EXECUTIONDATEN La date d'exécution du dernier paiement.

Il n'y a pas « EXECUTIONDATE1 » (date d'exécution 1) car le premier paiement aura lieu à la date de la transaction initiale.

  • Afin d’éviter l’expiration des données de l’autorisation initiale avant la demande de paiement suivante, le nombre maximal de jours entre deux dates d’exécution (EXECUTIONDATEN et EXECUTIONDATEN+1) dans une série de paiements échelonnés est limité à 43 jours.
  • Toutes les dates d'exécution doivent s'inscrire dans la période de conservation définie par la première date d'exécution (EXECUTIONDATE1) et le nombre maximal de jours fixé dans le Back Office, sous Configuration>Account>Data Retention Management (Configuration>Compte>Gestion de la conservation des données).

Notre système vérifiera si toutes les dates et tous les montants sont corrects, puis procédera au premier paiement. Si la première opération est réussie, les occurrences ultérieures sont stockées et exécutées aux dates demandées.

1.1 Signature SHA

La Signature SHA-IN doit contenir tous les champs des paiements planifiés.

2. Page de paiement hebergée

2.1 Exemple

Un client achète quelque chose sur votre site web pour 300 EUR le 10/04/2015. Vous donnez à votre client le choix de payer le montant total en une seule fois ou de payer en trois tranches : 1/3 maintenant, 1/3 le mois suivant (le 10/05/2015) et 1/3 dans deux mois (le 10/06/2015).

  • Champ caché au cas où votre client paie le montant total en une fois :

    <input type="hidden" name="AMOUNT" value="30000">

  • Champs cachés au cas où votre client paie le montant en trois tranches à l'aide des paiements échelonnés :

    <input type="hidden" name="AMOUNT" value="30000">

    <input type="hidden" name="AMOUNT1" value="10000">

    <input type="hidden" name="AMOUNT2" value="10000">

    <input type="hidden" name="EXECUTIONDATE2" value="10/05/2015">

    <input type="hidden" name="AMOUNT3" value="10000">

    <input type="hidden" name="EXECUTIONDATE3" value="10/06/2015">

2.2 Page de paiement

Lorsque vous utilisez des paiements échelonnés, la page de paiement apparaîtra comme ci-dessous, de manière à ce que le client puisse revoir ce qu'il a planifié. Ces informations sont répétées dans l'e-mail de confirmation.

Remarquez que, étant donné que seules les cartes de crédit sont acceptées pour le moment, les autres modes de paiement sont (intentionnellement) masqués sur la page de paiement.

3.1 Exemple

Un client achète quelque chose sur votre site web pour 300 EUR le 10/04/2014. Vous donnez à votre client le choix de payer le montant total en une seule fois ou de payer en trois tranches : 1/3 maintenant, 1/3 le mois suivant (le 10/05/2014) et 1/3 dans deux mois (le 10/06/2014).

    Le formulaire HTML au cas où votre client paie le montant total en une fois

    
<FORM METHOD="post" ACTION="https://secure.ogone.com/ncol/test/orderdirect.asp"> 
<INPUT type="text" NAME="PSPID" value="yourPSPID"> 
<INPUT type="text" NAME="ORDERID" VALUE="order123"> 
<INPUT type="text" NAME="USERID" value="yourUserId"> 
<INPUT type="text" NAME="PSWD" value="yourPassword"> 
<INPUT type="text" NAME="CARDNO" value="4111111111111111">
<INPUT type="text" NAME="ED" value="0233"> 
<INPUT type="text" NAME="CVC" value="123"> 
<INPUT type="text" NAME="AMOUNT" VALUE="1000"> 
<INPUT type="text" NAME="CURRENCY" VALUE="EUR"> 
</form>

    Le formulaire HTML au cas où votre client paie le montant en trois tranches à l'aide des paiements échelonnés

    
<FORM METHOD="post" ACTION="https://secure.ogone.com/ncol/test/orderdirect.asp"> 
<INPUT type="text" NAME="PSPID" value="yourPSPID"> 
<INPUT type="text" NAME="ORDERID" VALUE="order123"> 
<INPUT type="text" NAME="USERID" value="yourUserId"> 
<INPUT type="text" NAME="PSWD" value="yourPassword"> 
<INPUT type="text" NAME="CARDNO" value="4111111111111111"> 
<INPUT type="text" NAME="ED" value="0233"> 
<INPUT type="text" NAME="CVC" value="123"> 
<INPUT type="text" NAME="AMOUNT" VALUE="3000"> 
<INPUT type="text" NAME="AMOUNT1" VALUE="1000"> 
<INPUT type="text" NAME="AMOUNT2" VALUE="1000"> 
<INPUT type="text" NAME="AMOUNT3" VALUE="1000"> 
<INPUT type="text" NAME="EXECUTIONDATE1" VALUE="10/10/2021"> 
<INPUT type="text" NAME="EXECUTIONDATE2" VALUE="10/11/2021"> 
<INPUT type="text" NAME="EXECUTIONDATE3" VALUE="10/12/2021"> 
<INPUT type="text" NAME="CURRENCY" VALUE="EUR"> 
</form>

    4. Retour de transaction

    4.1 Statuts

    Les paiements échelonnés ont une référence unique (PAYID), avec plusieurs paiements.

    .

    .

    .

    Status Description
    56 - OK avec paiements planifiés Par défaut, une transaction avec paiements échelonnés aura un statut « 56 - OK with scheduled payments » (56 - Approbation des paiements échelonnés). Une fois la dernière tranche payée, la transaction aura pour statut « 9 - Payment requested » (“9 - Paiement demandé”)
    57 - Erreur dans les paiements planifiés En cas d'erreur pour un des paiements échelonnés, le statut de la transaction sera « 57 - Error on scheduled payments » (57 - Erreur pour paiements échelonnés). Par défaut, si un paiement échelonné est refusé ou contient une erreur, le système réessaiera une fois par jour, pendant 10 jours maximum. Si vous souhaitez modifier les tentatives pour tous les paiements futurs planifiés, contacter le helpdesk s'il vous plaît
    2 - Autorisation refusée Si le premier paiement est refusé, la transaction aura pour statut 2 - Autorisation refusée, tout comme pour une transaction standard, et aucun paiement échelonné ne pourra être déclenché. Après le traitement de tous les essais supplémentaires ayant abouti au statut 57, la transaction sera mise à jour en statut 93. Aucun essai supplémentaire ne sera réalisé par la suite
    87 - Deleted scheduled payment Si vous annulez un paiement à venir, le statut 87 sera attribué au versement échelonné. Vous pouvez trouver tout paiement annulé dans le Back Office en suivant ces étapes
    • Connectez-vous au Back Office. Rendez-vous sous Opérations > Gestion transactions et cherchez le PAYID
    • Sur l’écran d’aperçu des transactions, cliquez sur le bouton « SCHEDULED PAYMENTS (X TOTAL, Y UPCOMING) »

    Vous trouverez toutes les transactions annulées dans le tableau avec le statut=87

    4.2 Compte Worldline

    La page d'aperçu des transactions dispose d'un nouveau bouton, situé en bas, qui indique le nombre restant de paiements échelonnés. Une fois qu'un paiement échelonné a été exécuté, il apparaîtra dans la liste des opérations pour la commande.

    En cliquant sur ce bouton, vous obtiendrez l'écran suivant, qui vous donne un aperçu détaillé. En cas de besoin, un bouton « Delete » (Effacer) vous permet d'annuler les échéances futures.

    4.3 Code d'opération

    Si vous recourez à des paiements échelonnés, le paiement initial sera traité à l'aide du code d'opération par défaut défini dans l'onglet « Global transaction parameters » (paramètres généraux de transaction) de votre page d'informations techniques.

    Remarque : Si vous introduisez votre premier paiement après la date du prochain paiement échelonné, le paiement échelonné en question sera déclenché ce même jour.

    Cependant, tous les paiements (échelonnés) suivants seront traités comme des ventes directes, quelle que soit votre configuration.

    4.4 Opérations de maintenance

    Si vous avez effectué votre paiement initial à l'aide du code d'opération « Authorisation » (autorisation) (statut de la transaction « 5 - Authorised » - (5 - Autorisé)), vous pourrez annuler, saisir et même saisir partiellement le montant initial, mais les paiements échelonnés ne seront pas déclenchés avant que le montant initial ne soit complètement traité. Remarquez aussi que les annulations partielles ne sont pas possibles

    Si vous avez activé l'option, vous pouvez rembourser une transaction complètement ou partiellement. Remarquez que si vous procédez à un remboursement partiel, avec la case « last operation » (dernière opération) cochée, la transaction aura pour statut « 8 - Refunded » (8- remboursement) et les paiements échelonnés futurs ne pourront pas être déclenchés. Dans les autres cas, tant que la transaction aura le statut 56, les échéances futures seront traitées.

    Vous pouvez uniquement rembourser un montant inférieur ou égal à celui qui a déjà été encodé.