Confirmation of Funds

Confirmation of Funds Request Description

Creates a confirmation of funds request at the ASPSP.

API Profile

Attribute

Value

Name Confirmation of Funds Request
Version V1
Synopsis Confirmation of Funds Request
Description Creates a confirmation of funds request at the ASPSP.
Pre-Conditions HTTP POST method is allowed.
Authentication OAuth 2.0 with Authorization Code

Before your application can access the API, it must obtain a new an access token for each request. The access token can be used only one time.

Endpoint Definition

Account API’s development live and mock environments routing data

EndPoint SERVICE

URI /funds-confirmations/v1
Base URL https://apis.garantibbva.ro:443


Technology

Technology Stack / DESIGN TIME

Property Value
HTTP Call Method POST
Response Content Type application/json; charset=utf-8


APIS


Reads a list of bank accounts, with balances where required.


Request Header

Attribute

Type

Condition

Description

X-Request-ID UUID Mandatory ID of the request, unique to the call, as determined by the initiating party.
apikey String Mandatory API Key value obtained from Dashboard/Applications page in API Store, for SANDBOX/PRODUCTION plan.

Request Body

Attribute

Type

Condition

Description

cardNumber String Mandatory Card Number of the card issued by the PIISP. Should be delivered if available.
account Account Reference Mandatory PSU’s account number.
instructedAmount Amount Mandatory Transaction amount to be checked within the funds check mechanism.

Response Header

Attribute

Type

Condition

Description

X-Request-ID UUID Mandatory ID of the request, unique to the call, as determined by the initiating party.

Response Body

Attribute

Type

Condition

Description

fundsAvailable Boolean Mandatory Equals true if sufficient funds are available at the time of the request, false otherwise.


Sample Request


		
{ "cardNumber": "12345678901234", "account": {"iban": "DE23100120020123456789"}, "instructedAmount": {"currency": "EUR", "amount": "123"} }


Sample Response


		
{"fundsAvailable": true}


Types



Amount

Attribute

Type

Condition

Description

currency Currency Code Mandatory ISO 4217 Alpha 3 currency code
amount String Mandatory The amount given with fractional digits, where fractions must be compliant to the currency definition. Up to 14 significant figures. Negative amounts are signed by minus. The decimal separator is a dot. Example: Valid representations for EUR with up to two decimals are: * 1056 * 5768.2 * -1.50 * 5877.78

Account Reference

Attribute

Type

Condition

Description

iban IBAN Conditional  

		


Response Codes

Code

Description

Type

200 OK ACCEPTED SUCCESS
405 {http.method} Method Not Allowed CALL METHOD ERROR
400 Bad Request MISSING PARAMETERS
401 Invalid Credentials UNAUTHORIZED
404 Not Found NOT FOUND
500 Internal Server Error SYSTEM ERROR