Comment créer un portefeuille

L’utilisation en interface direct, vous obtenez une réponse dès envoie de votre demande.
La fonction « createWallet » permet de créer un portefeuille virtuel pour votre client. Afin de valider l’utilisation du portefeuille, Payline réalise un contrôle monétique du moyen de paiement par une transaction d’autorisation à 1 euro qui ne sera pas validée (pas de paiement réel).

La création est rejetée dans les cas suivants :

• L’identifiant du portefeuille virtuel fourni n’est pas unique ;
  
• La date d’expiration de la carte est dépassée ;
  
• Le résultat du contrôle monétique de la carte de paiement est un refus ;
  
• Les informations obligatoires ne sont pas renseignées.

La fonction « enableWallet » permet d’activer un portefeuille virtuel pour votre client, si ce dernier a été désactivé.

Comment utiliser un portefeuille

A l’aide d’un Portefeuille, il est possible d’effectuer différent mode de paiement

• un paiement comptant, ou différé ;
  
• un paiement récurrent ;
  
• un paiement à échéance.

Pour réaliser un paiement comptant ou différé

La fonction « doImmediateWalletPayment » réalise un paiement à partir d’un portefeuille virtuel.

Vous pouvez utiliser les modes de paiement comptant CPT et différé DIF avec cette fonction.

Le paiement est refusé dans les cas suivants :

• L’identifiant du portefeuille virtuel fourni n’existe pas ou le portefeuille est inactif ;
  
• La demande d’autorisation est refusée ;
  
• Le mode de paiement n’est pas accepté.

Un paiement à récurrent

La fonction « doRecurrentWalletPayment » enregistre un dossier de paiement pour une facturation automatique et récurrente de votre client. Payline traite, jour par jour, les échéances à réaliser et vous informe du résultat par la fonction de notification. 

Le dossier de paiement est caractérisé par :

• les informations d’un portefeuille virtuel existant ;
  
• des échéances de paiement : un montant, une devise, une date d’échéance, un statut, etc.

L’enregistrement du dossier de paiement est refusé dans les cas suivants :

• L’identifiant du portefeuille virtuel fourni n’existe pas ou le portefeuille est inactif ;
  
• Le montant du champ Payment.Amount n’a pas la bonne valeur ;
  
• Le mode de paiement n’est pas accepté.

Dans le cas où la date d’expiration de la carte bancaire ne couvre pas l’intégralité des échéances à venir, Payline vous alerte par le code retour 02506.

Si la carte bancaire arrive a expiration alors que vous avez encore des échéances et que vous n’avez pas modifié les coordonnées bancaires, le dossier passe en inactif et l’échéancier s’arrête, et il ne sera plus possible d’activer l’échéancier donc il faudra reprogrammer un échéancier.

Paiement à échéance

La fonction « doScheduledWalletPayment » enregistre une demande de paiement programmée et réalise le jour souhaité une demande d’autorisation de débit avec les données d’un portefeuille.  

Le dossier de paiement est caractérisé par :

• les informations d’un portefeuille virtuel existant
• des échéances de paiement : un montant, une devise, une date d’échéance, un statut, etc.

L’enregistrement de la demande est refusé dans les cas suivants :

• L’identifiant du portefeuille virtuel fourni n’existe pas ou le portefeuille est inactif ;
  
• La date de paiement souhaitée est au delà de la date d’expiration du moyen de paiement ;
  
• Le mode de paiement n’est pas accepté.

Le paiement est refusé uniquement si la demande d’autorisation est refusée.

Si la carte bancaire arrive a expiration alors que vous avez encore des échéances et que vous n’avez pas modifié les coordonnées bancaires, le dossier passe en inactif et l’échéancier s’arrête, et il ne sera plus possible d’activer l’échéancier donc il faudra reprogrammer un échéancier

Comment gérer son portefeuille

Il est possible de modifier un Portefeuille, de mettre à jour les données privées et/ou les données monétiques à l’aide de la fonction « updatewallet », et il est tout à fait possible de désactiver un Portefeuille à l’aide de la fonction « disableWallet », lorsqu’un portefeuille est désactivé, il n’est plus possible d’effectuer des paiements via celui-ci.

Information du portefeuille

A tout moment, il est possible d’utiliser les fonctions suivantes qui vous permettent d’interroger votre Portefeuille :

• « getWallet » cette fonction permet de récupérer les informations qui constituent un portefeuille client ;
• « getPaymentRecord » cette fonction permet de récupérer les informations d’un dossier de paiement récurrent.