Obtenir les transactions

 

➤ Prérequis

Cet appel permet de récupérer la liste des opérations d'un compte de paiement du PSU (usager d'un service de paiement) pour lequel l'AISP (prestataire de service de paiement) est connecté.

Les transactions obtenues sont inférieures ou égales à 90 jours par rapport à la date du jour.

Une pagination de la liste renvoyée peut être faite s'il y a beaucoup de données à afficher, dans ce cas des liens de navigation donnant accès à la première page, la précédente, la suivante et la dernière page faciliteront la consultation des résultats (voir la section "Limitations" pour le nomber de résultats max retourné par page).

Un lien self sera également présent pour revenir à la page obtenue juste après exécution de la requête.

Ce service fait suite à la restitution de la liste des comptes de paiement d'un client : un identifiant de ressource correspondant à un compte doit être fourni pour obtenir la liste des transactions. 

Les accès à cette méthode sont limités à 4 accès batch maximum par jour calendaire, pour un client, pour un compte ou pour un TPP, hors pagination.

 

➤ Requête

"GET /accounts/{accountRessourceId}/transactions"

 

➤ Paramètres

Paramètre accountRessourceId  : compte paiement pour lequel on veut consulter les opérations, cette donnée correspond à la rubrique "ressourceId" obtenue dans la page de résultat de la requête get/accounts.

Paramètres facultatifs :

  • dateFrom (date limite de début pour les transactions recherchées)
  • dateTo (date limite de fin pour les transactions recherchées)
  • afterEntryReference (référence d'incrément minimum pour l'identifiant technique)

 

➤ Exemple

Requête

GET www.30007.sandbox.api.89c3.com/stet/psd2/v1.6.2/accounts/EURFR353000799999A40166510BB25/transactions

 

Résultat

Status code : HTTP 200

 

Body

    

{
"_links": {
"last": {
},
"self": {
},
"first": {
}
},
"transactions": [
{
"resourceId": "USD04139485000",
"remittanceInformation": "INTERETS PAYES",
"transactionAmount": {
"amount": "12486.60",
"currency": "USD"
},
"bookingDate": "2019-02-24",
"creditDebitIndicator": "CRDT",
"entryReference": "USD04139485000",
"status": "BOOK"
},
{
"resourceId": "EUR04097970000",
"remittanceInformation": "INTERETS ENCAISSES",
"transactionAmount": {
"amount": "57.60",
"currency": "EUR"
},
"bookingDate": "2019-02-27",
"creditDebitIndicator": "DBIT",
"entryReference": "EUR04097970000",
"status": "BOOK"
},
{
"resourceId": "GBP04097970003",
"remittanceInformation": "INTERETS ENCAISSES",
"transactionAmount": {
"amount": "7.82",
"currency": "EUR"
},
"bookingDate": "2019-03-01",
"creditDebitIndicator": "DBIT",
"entryReference": "GBP04097970003",
"status": "BOOK"
},
{
"resourceId": "JPY04097970001",
"remittanceInformation": "INTERETS ENCAISSES",
"transactionAmount": {
"amount": "22.64",
"currency": "EUR"
},
"bookingDate": "2019-02-26",
"creditDebitIndicator": "DBIT",
"entryReference": "JPY04097970001",
"status": "BOOK"
},
{
"resourceId": "USD04097970002",
"remittanceInformation": "INTERETS ENCAISSES",
"transactionAmount": {
"amount": "287.44",
"currency": "EUR"
},
"bookingDate": "2019-03-02",
"creditDebitIndicator": "DBIT",
"entryReference": "USD04097970002",
"status": "BOOK"
},
{
"resourceId": "TOP924H5J0000705",
"remittanceInformation": "TRANSFERT BANCO INTERNACIONAL",
"transactionAmount": {
"amount": "1850.00",
"currency": "USD"
},
"bookingDate": "2019-03-03",
"creditDebitIndicator": "DBIT",
"entryReference": "TOP924H5J0000705",
"status": "BOOK"
}
]
}

 

 

➤ Tests d'acceptance

Ces tests ont pour objectif de s'assurer que l'API respecte la norme STET. Ils devraient être validés avant tout déploiement applicatif. 

Description du test

Nature du test

Jeu de données

Récupération de toutes les transactions d'un compte (sous 90 jours)


contexte de prise en charge du PSU = BY-AISP

scope OAuth2 = aisp

Obligatoire

Persona :

Utilisateur : WUBUPA57

Compte :EURFR353000799999A40166510BB25

Résultat : Restitution des transactions du compte de paiement

Récupération des transactions liés à un compte inconnu

=>Un code HTTP 404 est renvoyé : compte inconnu

Obligatoire

Persona :

Utilisateur : WUBUPA57

Compte : EURFR7630007999990409797000000

Résultat : Un message d'erreur HTTP 404 est retourné