Vérifiez la disponibilité des fonds
Ce service permet de vérifier la disponibilité des fonds pour le compte de notre client pour un montant donné d'une transaction.
➤ Prérequis
Pour procéder à cette requête il est nécessaire de remplir les prérequis d’éligibilité, d'avoir récupéré le jeton d'accès OAUTH2 (voir le cas d'usage "Récupérez votre jeton") et de fournir les paramètres du body.
➤ Requête
POST /funds-confirmations
Paramètres obligatoires du body requis pour l'appel de ce service
- paymentCoverageRequestId : Identifiant de la requête de paiement
- instructedAmount : La structure comprenant le montant renseigné ainsi que la devise
- currency : Devise du montant renseigné
- amount : Montant qui permettra de déterminer si les fonds sont disponibles
- accountId : Identifiant unique pour le compte renseigné
- iban : Numéro de compte bancaire international (IBAN)
➤ Réponse
Le résultat retourné reprendra les informations de la requête ainsi que la réponse concernant la disponibilité des fonds sous la forme d'un booléen.
Un lien self sera également présent pour revenir à la page obtenue juste après exécution de la requête .
➤ Exemple
Requête
Body
{ "paymentCoverageRequestId" : "MyCoverage123456", "instructedAmount" : { "currency" : "EUR", "amount" : "12345" }, "accountId" : { "iban" : "YY13RDHN98392489481620896668799742" } } } |
Résultat
Status code : 200
Body
{ "request" : { "paymentCoverageRequestId" : "MyCoverage123456", "instructedAmount" : { "currency" : "EUR", "amount" : "12345" }, "accountId" : {"iban" : "YY13RDHN98392489481620896668799742" } }, "result" : true, "_links" : { "self" : { "href" : "v1/funds-confirmations" } } } |