Accounts BG API Sandbox

During tests of your APIs you can use details defined below. Those are non-real test data. Note however that this sandbox API only contains static examples, i.e., the information is not real-time at this point.

Refresh tokens are issued with validity of 24 hours (instead of 90 days for production APIs).

Balance types:

InterimAvailable - Balance of the account (with credit limit) at the end of previous day (D-1) without pending items. It is the sum of the opening booked balance at (D-1) and all entries booked to the account during (D-1) (without pending items, including fees and commissions).

Expected – actual accounting balance on the account (with credit limit) composed of booked entries and pending items (booked balance + credit limit - blocked amount)

PSU-IP-Address to AISP endpoints:

  • PSU-IP-Address and other PSU related attributes are optional fields in all Accounts API requests
  • PSU-IP-Address (IP Address field between PSU and TPP) is conditional for you (TPP): It shall be contained if and only if this request was actively initiated by the PSU.

That means, if PSU-IP-Address is provided, that request is NOT counted

If PSU-IP-Address is NOT provided, that request is counted (as request without PSU’s involvement)

  • As per RTS, we allow only 4 calls per endpoint without PSU’s involvement in 24 hours

Example: consent was given for 2 accounts with "access" balances and transactions and frequency per day is 4:

We allow 4 calls GET /accounts/accountId1, 4 calls GET /accounts/accountId1/balances, 4 calls GET/accounts/accountId1/transactions

And we allow 4 calls GET /accounts/accountId2, 4 calls GET /accounts/accountId2/balances, 4 calls GET/accounts/accountId2/transactions

  • You as TPP have the responsibility to fill in the PSU-IP-Address truthfully – detected misuse will be reported to national regulators.

Test Data

ClientName userID Password File related Account Number IBAN Account currency Description Accounts data Balances data Balance amount Transaction data
  1000000001 Pass101   N/A N/A N/A 1 PSU with no accounts Not needed Not needed Not needed Not needed
Ry Start 1000000002 Pass102   1000333580 BG40RZBB91551000333580 BGN 1 PSU with 1 account (with balance = 0 and no transaction) Yes Yes 0 Empty
Ivan Petrov 1000000003 Pass103   1000333596 BG93RZBB91551000333596 EUR 1 PSU with 1 account (with negative balance and no transaction) Yes Yes -123,56 Empty
UCB EOOD 1000000004 Pass104   1000333615 BG65RZBB91551000333615 JPY 1 PSU with 1 account (with positive balance and no transaction) Yes Yes 632,45 Empty
Asset 1000000005 Pass105   1000333620 BG27RZBB91551000333620 BGN 1 PSU with 1 account (with balance = 0 and 1 transaction) Yes Yes 0 Yes
Poli Boneva 1000000006 Pass106   1000333641 BG42RZBB91551000333641 EUR 1 PSU with 1 account (with negative balance and 1 transaction) Yes Yes -45,78 Yes
Global ET 1000000007 Pass107   1000333657 BG95RZBB91551000333657 USD 1 PSU with 1 account (with positive balance and 1 transaction) Yes Yes 65,41 Yes
Dona Dineva 1000000008 Pass108   1000333678 BG13RZBB91551000333678 BGN 1 PSU with 1 account (with balance = 0 and 101 transactions: "31 older than 90 days transaction and 70 not older than 90 days") Yes Yes 0 Yes
Mono Renev 1000000009 Pass109   1000333683 BG72RZBB91551000333683 EUR 1 PSU with 1 account (with negative balance and 101 transactions: "31 older than 90 days transaction and 70 not older than 90 days") Yes Yes -36987,58 Yes
Stor OOD 1000000010 Pass110   1000333718 BG97RZBB91551000333718 USD 1 PSU with 1 account (with positive balance and and 101 transactions: "31 older than 90 days transaction and 70 not older than 90 days") Yes Yes 74125,35 Yes
Demo ET 1000000011 Pass111   1000333750 BG09RZBB91551000333750 BGN 1 PSU with multiple accounts (at least 10 accounts) Yes Yes 0 Empty
  1000333786 BG07RZBB91551000333786 EUR Yes Yes -0,9 Empty
  1000333791 BG66RZBB91551000333791 USD Yes Yes 0,87 Empty
  1000333810 BG38RZBB91551000333810 JPY Yes Yes 9684,32 Yes
  1000333826 BG91RZBB91551000333826 BGN Yes Yes -4521,18 Yes
  1000333831 BG53RZBB91551000333831 BGN Yes Yes 0 Yes
  1000333847 BG09RZBB91551000333847 EUR Yes Yes -854,48 Yes
  1000333873 BG83RZBB91551000333873 EUR Yes Yes 63217,12 Yes
  1000333894 BG98RZBB91551000333894 JPY Yes Yes -521,51 Yes
  1000333908 BG11RZBB91551000333908 USD Yes Yes 0 Yes

 

Currency Rate
1 EUR 1.8939 BGN
1 USD 1.5151 BGN
1 JPY 0.0151 BGN

 

Note: Keep in mind that date format you’ll find in the examples is YYYY-MM-DDThh:mm:ss.sssZ where Z is the time zone (+1:00, -1:00) but the format that need to be used is YYYY-MM-DD