XS2A interface (for PSD2)
The XS2A interface of BTG Pactual Europe S.A. provides, in accordance with §66 and §67 of PSD2 (DIRECTIVE (EU) 2015/2366 OF THE EUROPEAN PARLIAMENT AND OF THE COUNCIL of 25 November 2015), access to the payment accounts in the case of payment initiation services and access to payment account information and its use in the case of account information services.
The payment accounts of BTG Pactual Europe S.A. have been accessable on-line since January 2023.
Since April 2021, the testing facility (hereinafter referred to as the "Sandbox") has been fully available to all payment initiation and account information service providers.
It is possible for our customers to access payment account information and make individual transfers. If you have any questions, please contact us at info@f-i-s.lu.
Our "XS2A API" interface follows the specifications of the Berlin Group. The interface is operated by finAPI GmbH, Adams-Lehmann-Str. 44, D - 80797 Munich.
Test Interface - XS2A-Sandbox
The test interface ("XS2A-Sandbox") provides pure test data, which is managed by finAPI GmbH. It is not possible to draw conclusions about the data of FIS BTG Pactual Europe S.A. customers.
For all details on the interface, please refer to the "Developer Documentation".
Access to the sandbox is possible with a valid PSD2 test certificate.
Developer Documentation
The developer documentation provides you with a technical description of the individual API functions. The documentation is only available in English.
Scoope of service
The XS2A interface of BTG Pactual Europe S.A. covers the following use cases:
| Area | Service (use case) | Description | Remark on products and services in-scope / out-of-scope |
|---|---|---|---|
| Account Information Service | Cash account balance - all accounts | Provision of a list of all available cash accounts (with or without balances) for a client number. | All cash accounts accessible by the user are provided. Each cash account is identified by an IBAN. |
| Account Information Service | Cash account balance - dedicated account | Provision of the balance for a dedi-cated cash account. | Accounts identified by an IBAN can be used. IBAN can be retrieved using the service "Cash account balance - all accounts". |
| Area | Service (use case) | Description | Remark on products and services in-scope / out-of-scope |
|---|---|---|---|
| Account Information Service | Transaction history - dedicated account | Provision of the transaction history (movements) for a dedicated cash account. | Accounts identified by an IBAN can be used. IBAN can be retrieved using the service "Cash account balance - all accounts". Booking status "booked" or "both" are supported. "Pending" and "infor-mation" are out-of-scope. |
| Account Information Service | Transaction details - dedicated transaction | Provision of the details for a dedicated transaction (movement). | The identifier of the dedicated movement can be retrieved by using the service "Transaction history - ded-icated account". The service will provide the details for booked transactions. |
| Area | Service (use case) | Description | Remark on products and services in-scope / out-of-scope |
|---|---|---|---|
| Payment Initiation Service | Payment initiation - single payment | Initiation of a credit transfer from a cash account. | In-scope: Services: |
| Payment Initiation Service | Payment cancellation request | Request for cancellation of a pending payment | Payments in status "PNDG" can be requested for cancellation in the scope described in section “Payment initiation - single payment”. |
| Payment Initiation Service | Payment initiation status request | Request for provision of current status of an initiated payment | Scope described in section “Payment initiation - single payment”. |
| Area | Service (use case) | Description | Remark on products and services in-scope / out-of-scope |
|---|---|---|---|
| Confirmation of the availability of funds for the execution of a card-based payment transaction | Confirmation of funds | Request for confirmation of funds for a card-based payment |
Support access
Developers can submit requests for the XS2A interface via the support access. Support for requests submitted in this way is provided by finAPI GmbH for BTG Pactual Europe S.A.
Alternatively, support requests can be sent by e-mail to xs2a-support@finapi.io
Other requests can be sent to BTG Pactual Europe S.A. (e-mail address info@f-i-s.lu).
Productive XS2A interface
Access to the productive XS2A interface is possible with a valid QWAC certificate.
To the productive XS2A interface →
Description XS2A Fallback
The description of the XS2A fallback solution is available at the link below:
Link to file Fallback_Documentation.pdf →
Link to file finapi_swagger.yaml →
Publication of XS2A statistics
Quarterly statistics on the availability and performance of our XS2A interface will be published in due course.