BerlinGroup Standard - AIS

Berlin Group
AIS specifications of PSD2 API based on the Berlin Group specification 1.1 for NextGen PSD2 (May 11 2018)

01 - Manage Consents for Account Information Service

To access all AIS APIs, it is necessary to establish a consent between the TPP, the PSU and the ASPSP

02 - Initiate a Payment

Overview of the APIs used to initiate a payment regardless of the service and product used

03 - Cancel a Payment

Overview of the APIs used to cancel a payment regardless of the service and product used

05 - Manage payments information and status

Retrieving the payment resource or the status of the transaction following a payment initiation or cancellation

07 - Specific BerlinGroup Implementation

Since the BerlinGroup Implementation Guide gives ASPSPs the possibility to make some functionalities optional, you can find a summary of them in this documentation

08 - Use our Sandbox Dataset

Our Sandbox environment is filed with a small dataset allowing you to test our APIs. Here is a quick overview

09 - Contact our support team

To help TPPs access our PSD2 APIs a dedicated team is available for support

10 - Connect to the sandbox or Berlin Group APIs

Operating procedure for the connection to the sandbox or Berlin Group APIs

11 - Build your authorize URL

Explains the process to build the authorize URL to access the authentication of the PSU

POST

createPaymentAuthorisationUsingPOST

/berlingroup/v1/{payment-service}/{payment-product}/{paymentId}/{payment-authorisation}

Start the authorisation process for a payment initiation or cancellation


Apr
19

Documentation Web Scraping Amélioré (WSA) pour l'Ancienne Offre – Evolution Avril 2021


Correctif du 17/12/2021

La présente page a été mise à jour pour indiquer l'url permettant d'accéder directement au sous-espace dédié aux produits bancaires de l'espace Groupama qui est le seul sous-espace devant être accédé par ce biais :
https://espaceclient.groupama.fr/wps/myportal/TableauDeBord

 


BerlinGroup Standard - PIS

Berlin Group
PIS specifications of PSD2 API based on the Berlin Group specification 1.1 for NextGen PSD2 (May 11 2018)

GET

cancelAuthorizeUsingGET

/berlingroup/authorization/cancel/authorize/{authorization-id}

OAuth2 Cancellation Authorize request. See How To Build your authorize URL for more information

BerlinGroup Standard - OAuth2.0

Berlin Group
OAuth2.0 specifications of PSD2 API based on the Berlin Group specification 1.1 for NextGen PSD2 (May 11 2018)

GET

getPaymentStatusUsingGET

/berlingroup/v1/{payment-service}/{payment-product}/{paymentId}/status

Payment initiation status request

POST

createPaymentUsingPOST

/berlingroup/v1/{payment-service}/{payment-product}

Payment initiation request for single and periodic payments

POST

createTokenUsingPOST

/berlingroup/v1/token

Exchange the authorisation code provided in the authorisation response for an access token. Make sure to use for this request a body encoded as x-www-form-urlencode

GET

getPeriodicPaymentUsingGET

/berlingroup/v1/periodic-payments/{payment-product}/{paymentId}

Get Payment Information for periodic payments

GET

getPaymentUsingGET

/berlingroup/v1/payments/{payment-product}/{paymentId}

Get Payment Information for single payments

GET

getConsentAuthorizationUsingGET

/berlingroup/v1/consents/{consent-id}/authorisations/{authorisation-id}

Read the SCA status of the consent authorisation.

GET

getConsentStatusUsingGET

/berlingroup/v1/consents/{consent-id}/status

Consent status request

POST

createConsentAuthorizationUsingPOST

/berlingroup/v1/consents/{consent-id}/authorisations

Start the authorisation process for a consent

GET

getConsentAuthorizationsUsingGET

/berlingroup/v1/consents/{consent-id}/authorisations

Get Consent Authorisation Sub-Resources Request

DELETE

deleteConsentUsingDELETE

/berlingroup/v1/consents/{consent-id}

Delete Consent

GET

getAccountListUsingGET

/berlingroup/v1/accounts

Read Account List

GET

getPeriodicPaymentUsingGET

/berlingroup/v1/periodic-payments/{payment-product}/{paymentId}

Get Payment Information for periodic payments

GET

getAuthorizationUsingGET

/berlingroup/v1/{payment-service}/{payment-product}/{paymentId}/{payment-authorisation}/{authorisation-id}

Read the SCA Status of the payment authorisation

POST

createPaymentAuthorisationUsingPOST

/berlingroup/v1/{payment-service}/{payment-product}/{paymentId}/{payment-authorisation}

Start the authorisation process for a payment initiation or cancellation

GET

getAuthorizationsUsingGET

/berlingroup/v1/{payment-service}/{payment-product}/{paymentId}/{payment-authorisation}

Returns a list of the all authorisations subresources IDs which have been created

GET

getPaymentStatusUsingGET

/berlingroup/v1/{payment-service}/{payment-product}/{paymentId}/status

Payment initiation status request

GET

cancelAuthorizeUsingGET

/berlingroup/authorization/cancel/authorize/{authorization-id}

OAuth2 Cancellation Authorize request. See How To Build your authorize URL for more information

POST

createTokenUsingPOST

/berlingroup/v1/token

Exchange the authorisation code provided in the authorisation response for an access token. Make sure to use for this request a body encoded as x-www-form-urlencode

POST

createConsentUsingPOST

/berlingroup/v1/consents

Create consent

DELETE

deleteConsentUsingDELETE

/berlingroup/v1/consents/{consent-id}

Delete Consent

GET

getAccountListUsingGET

/berlingroup/v1/accounts

Read Account List

GET

getConsentStatusUsingGET

/berlingroup/v1/consents/{consent-id}/status

Consent status request

GET

getAccountDetailsUsingGET

/berlingroup/v1/accounts/{account-id}

Read Account Details


Jul
30

Production API General Availability and Devportal/Sandbox update


Production API General Availability

Starting today, the OrangeBank's BerlinGroup PDS2 Production API is available to TPP at the base URL "https://api-tpp.orangebank.fr" ( as described here )

It requires a Production PDS2 QWAC certificate.

The Production API is currently at the version V3 of our platform, which behaves as the previously available sandbox.  



Oct
22

Documentation Web Scraping Amélioré pour la Nouvelle Offre Orange Bank


Principes généraux de la solution de Web Scraping Amélioré (WSA) sur la nouvelle offre Orange Bank

Dans le cadre du WSA, Orange Bank donnera aux TPPs un accès privilégié à l'Espace Client Web (qui est une SPA Angular qui effectue des appels d'API). Cet espace est disponible à l'adresse suivante : https://www.orangebank.fr/espace-client/.


GET

getAuthorizationUsingGET

/berlingroup/v1/{payment-service}/{payment-product}/{paymentId}/{payment-authorisation}/{authorisation-id}

Read the SCA Status of the payment authorisation

GET

getAccountDetailsUsingGET

/berlingroup/v1/accounts/{account-id}

Read Account Details

DELETE

cancelPaymentUsingDELETE

/berlingroup/v1/{payment-service}/{payment-product}/{paymentId}

Payment Cancellation Request

GET

getAuthorizationsUsingGET

/berlingroup/v1/{payment-service}/{payment-product}/{paymentId}/{payment-authorisation}

Returns a list of the all authorisations subresources IDs which have been created

GET

getAccountTransactionsUsingGET

/berlingroup/v1/accounts/{account-id}/transactions

Read transaction list of an account

GET

authorizeUsingGET

/berlingroup/authorize/{authorization-id}

OAuth2 Authorize request. See How To Build your authorize URL for more information

GET

getAccountBalancesUsingGET

/berlingroup/v1/accounts/{account-id}/balances

Read Balance

GET

getConsentUsingGET

/berlingroup/v1/consents/{consent-id}

Get Consent Request


Jun
13

[UPDATE] - Avaibility of our Groupama Banque universe


Dear everyone,

Important information : Please note that the availability of our Groupama Banque App (Gbanque) will end on the 08/31/22, and the access to our Groupama Web site customer area will be closed mid-December 2022.

By the end of August 2022, all our GBanque customers will be told that their Groupama Banque universe will be unreachable after these dates and will be requested to move to their Orange Bank dedicated area : new App & new website.


POST

createConsentUsingPOST

/berlingroup/v1/consents

Create consent

DELETE

cancelPaymentUsingDELETE

/berlingroup/v1/{payment-service}/{payment-product}/{paymentId}

Payment Cancellation Request

POST

createPaymentUsingPOST

/berlingroup/v1/{payment-service}/{payment-product}

Payment initiation request for single and periodic payments

GET

getPaymentUsingGET

/berlingroup/v1/payments/{payment-product}/{paymentId}

Get Payment Information for single payments

GET

authorizeUsingGET

/berlingroup/authorize/{authorization-id}

OAuth2 Authorize request. See How To Build your authorize URL for more information

GET

getConsentAuthorizationUsingGET

/berlingroup/v1/consents/{consent-id}/authorisations/{authorisation-id}

Read the SCA status of the consent authorisation.

GET

getAccountBalancesUsingGET

/berlingroup/v1/accounts/{account-id}/balances

Read Balance

GET

getAccountTransactionsUsingGET

/berlingroup/v1/accounts/{account-id}/transactions

Read transaction list of an account

GET

getConsentUsingGET

/berlingroup/v1/consents/{consent-id}

Get Consent Request

POST

createConsentAuthorizationUsingPOST

/berlingroup/v1/consents/{consent-id}/authorisations

Start the authorisation process for a consent

GET

getConsentAuthorizationsUsingGET

/berlingroup/v1/consents/{consent-id}/authorisations

Get Consent Authorisation Sub-Resources Request


Apr
04

[KPI] 2023 - Q1 KPI Publication


Dear developers, you will find below an overview and the details of the KPI for the Q1 2023 period (from 01/01/2023 until 31/03/2023)

KPIs of the platform

Endpoints  

Response time

ms

Uptime

%

Downtime

%

Error Rate

%

AIS balances & transactions 1055 99,999 0.001 0.195
PIS

single

bulk

197

0

99,999 0.001 0.195
FCS   0