HiPay Enterprise – Virtual IBAN look-up

Virtual IBAN look-up

 

Please note: the virtual IBAN is only available on the Production account.

 

1. Requirements

 

2. Request parameters

- external_reference:

ID defined by the merchant and provided in the virtual IBAN creation request

 

Example of a PHP request

  

3. Returned responses to look-up requests

Format

- In XML by default

- Optionally in JSON if the “Accept” HTTPHEADER only contains “application/json”

 

Content

• code

For instance:

- 0 for success

- 1010201 for a problem with the input data

 

• message (explaining the code)

For instance:

- “Many virtual ibans have been found.”

 

• virtual_ibans

(including a list of 0 to N virtual_ibans containing the following parameters):

- iban

- bic

- creation_date (YYYY-MM-DD format)

- expiry_date (YYYY-MM-DD format)

- external_reference

 

Example of an XML response

 

Example of a JSON response