Obtenir le statut d’une demande d’initiation de paiement
➤ Cas d'usage
Cette méthode permet au PISP d'obtenir le statut d’une demande d’initiation de paiement précédemment envoyée à l’ASPSP, et pour un PSU donné.
➤ Prérequis
Pour procéder à cette requête il est nécessaire de remplir les prérequis d’éligibilité et d'avoir récupéré le jeton d'accès OAUTH2 (voir la rubrique "Récupérer un jeton").
Le TPP a déjà envoyé une requête qui a été enregistrée par l'ASPSP et à laquelle l'ASPSP a répondu avec un lien de localisation vers la demande d'initation de paiement ou de virement sauvegardée.
➤ Requête
GET /payment-requests/{paymentRequestResourceId}
Paramètre obligatoire paymentRequestResourceId : identifiant de la requête d'initiation de paiement pour laquelle on souhaite accéder au statut.
➤ Résultat retourné
A la soumission de la requête et si toutes les données sont correctement formatées, une réponse (HTPP 200) sera retournée.
Cette réponse contiendra les données de l'initiation de paiement enrichies du statut de la requête d'initiation et du paiement associé telles que définies dans la spécification STET version v1.6.2.0.
Le tableau suivant reprend les valeurs possibles pour le statut de l'initiation de paiement et de la transaction de paiement associée suite à une requête d'initiation de paiement :
Etape de traitement | Résultat de l'étape | Valeur de paymentInformationStatus à l'issue de l'étape | Valeur de creditTransferTransaction / transactionStatus à l'issue de l'étape |
---|---|---|---|
Contrôle et enregistrement de la requête d'initiation | OK | ACTC | - |
KO | RJCT | - | |
Consentement (début consommation de l'URL consentAproval) | OK | ACCP | - |
KO | RJCT | - | |
Demande d'exécution du paiement (juste avant retour REDIRECT vers l'application du TPP) | OK | ACSP (ou PDNG uniquement en environnement sandbox) | PDNG si virement exécuté à J, ACSP sinon (forcé à PDNG en environnement sandbox) |
KO | RJCT | RJCT | |
Si le PSU ne fait aucune action de consentement (validation ou refus) dans les 30 minutes suivant la requête d’initiation | - | RJCT (raison NOAS) | RJCT (raison NOAS) |
Date d'exécution du paiement avant mise à jour du statut la nuit | - | ACSP | ACSP |
Date d’exécution de paiement après mise à jour du statut la nuit | OK | ACSC | ACSC |
KO | RJCT | RJCT |
Le tableau suivant reprend les valeurs possibles pour le statut de l'initiation de paiement et de la transaction de paiement associée suite à une requête d’annulation d’une initiation de paiement:
Etape de traitement | Résultat de l'étape | Valeur de paymentInformationStatus à l'issue de l'étape | Valeur de crediTransferTransaction / transactionStatus à l'issue de l'étape |
---|---|---|---|
Avant réception de la demande d'annulation du paiement | - | ACTC / ACCP / ACSP | - / PDNG (si paymentInformationStatus = ACSP) |
Contrôle et enregistrement de l’annulation de requête d'initiation juste avant la réponse à la requête d’annulation | OK | RJCT / RJCT / ACSP | - / PDNG (si paymentInformationStatus = ACSP) |
KO | ACTC / ACCP / ACSP | - / PDNG (si paymentInformationStatus = ACSP) | |
Consentement | OK | ACSP | PDNG |
KO | ACSP | PDNG | |
Appel au service d’annulation du paiement juste avant la redirection sur l’application du TPP | OK | CANC (DS02, DUPL, FRAD, TECH) | CANC (DS02, DUPL, FRAD, TECH) |
KO | ACSP | PDNG |
➤ Restitution de l’IBAN du compte débité
L’IBAN du compte débité est systématiquement retourné par cette requête, même si cette donnée n’était pas présente dans la requête initiale de demande d’initiation de paiement.
➤ Codes erreur
Type d'erreur | Code HTTP | Libellé | Motif |
---|---|---|---|
Mauvais access token, problème d'authentification | 403 | Forbidden | |
Request resource inconnu | 404 | Not Found | Ressource inconnue |
Mauvaise requête ou requête hors périmètre autorisé | 405 | Method not allowed | |
Message générique | 500 | Internal server error | |
Requête en doublon | 500 | Internal server error | error : Problème d'insertion en base de donnée, clé unique dupliquée |