View a Bank Account

Path parameters

BankAccountId

string

required

The unique identifier of the bank account.

Responses

200 - IBAN-type

OwnerAddress

object

Information about the address of residence of the bank account owner.

Show properties

AddressLine1

string

Max. length: 255 characters

The first line of the address.

AddressLine2

string

Max. length: 255 characters

The second line of the address.

City

string

Max. length: 255 characters

The city of the address.

Region

string

Max. length: 255 characters

The region of the address. This field is optional except if the Country is US, CA, or MX.

PostalCode

string

Max. length: 255 characters

The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.

Country

string

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The country of the address.

IBAN

string

Max. length: 34 characters

The IBAN (international bank account number) of the bank account. It follows the CCDDBBAN format in which:

• CC represents the country code (ISO 3166-1 alpha 2)
• DD represents two check digits used by banking systems to avoid simple errors
• BBAN stands for the Basic Bank Account Number which is up to 30 alphanumeric characters that are country-specific.
  Note: You will need a valid IBAN (i.e., existing in real life) when testing on a Sandbox account even if no actual payout will be processed.

BIC

string

The BIC (international identifier of the bank) for IBAN or OTHER-type bank accounts.
The BIC can have one of the two following formats:

• BIC8 – 8-character BIC (AAAABBCC)
• BIC11 – 11-character BIC (AAAABBCCDDD)
  In which:
• AAAA represents the bank code: 4 characters defining the bank
• BB represents the country code: 2 characters forming the country ISO code (ISO 3166 format)
• CC represents the location code: 2 localization characters (alphabetical or numeric) to distinguish banks from the same country
• DDD represents the branch code: 3 optional characters defining the branch as a branch of the bank
  Note: You will need a valid IBAN (i.e., existing in real life) when testing on a Sandbox account even if no actual payout will be processed.

UserId

string

The unique identifier of the User (natural or legal) who owns the bank account.

OwnerName

string

Max. length: 255 characters

The full name of the owner of the bank account. (Format: FirstName LastName)

Type

string

Returned values: IBAN, US, CA, GB, OTHER

The type of the bank account, indicating the country where the real-life account is registered
The values are:

• IBAN – For accounts registered in countries that use IBAN 
• US – For accounts registered in the United States 
• CA – For accounts registered in Canada
• GB – For accounts registered in the United Kingdom
• OTHER – For accounts registered in countries that do not use IBAN (and are not US, CA, GB)

Id

string

The unique identifier of the object.

Tag

string

Max. length: 255 characters

Custom data that you can add to this object.
For bank accounts, you can use this parameter to identify the bank account by currency or usage (personal or professional for instance).

CreationDate

timestamp

The date and time at which the object was created.

Active

boolean

Whether or not the Bank Account is active. Mangopay automatically sets this parameter to false if the bank account is closed or does not exist anymore.

200 - GB-type

OwnerAddress

object

Information about the address of residence of the bank account owner.

Show properties

AddressLine1

string

Max. length: 255 characters

The first line of the address.

AddressLine2

string

Max. length: 255 characters

The second line of the address.

City

string

Max. length: 255 characters

The city of the address.

Region

string

Max. length: 255 characters

The region of the address. This field is optional except if the Country is US, CA, or MX.

PostalCode

string

Max. length: 255 characters

The postal code of the address. The postal code can contain the following characters: alphanumeric, dashes, and spaces.

Country

string

Format: Two-letter country code (ISO 3166-1 alpha-2 format)

The country of the address.

AccountNumber

string

Length: 8 digits

The unique set of digits of the bank account.

SortCode

string

The 6-digit sort code, assigned to UK financial institutions, for GB-type bank accounts.

UserId

string

The unique identifier of the User (natural or legal) who owns the bank account.

OwnerName

string

Max. length: 255 characters

The full name of the owner of the bank account. (Format: FirstName LastName)

Type

string

Returned values: IBAN, US, CA, GB, OTHER

The type of the bank account, indicating the country where the real-life account is registered
The values are:

• IBAN – For accounts registered in countries that use IBAN 
• US – For accounts registered in the United States 
• CA – For accounts registered in Canada
• GB – For accounts registered in the United Kingdom
• OTHER – For accounts registered in countries that do not use IBAN (and are not US, CA, GB)

Id

string

The unique identifier of the object.

Tag

string

Max. length: 255 characters

Custom data that you can add to this object.
For bank accounts, you can use this parameter to identify the bank account by currency or usage (personal or professional for instance).

CreationDate

timestamp

The date and time at which the object was created.

Active

boolean

Whether or not the Bank Account is active. Mangopay automatically sets this parameter to false if the bank account is closed or does not exist anymore.

200 - IBAN-type

{
    "OwnerAddress":{
        "AddressLine1":"The Oasis",
        "AddressLine2":"Rue des plantes",
        "City":"Paris",
        "Region":"Ile de France",
        "PostalCode":"75010",
        "Country":"FR"
    },
    "IBAN":"FR7630004000031234567890143",
    "BIC":"CRLYFRPP",
    "UserId":"user_m_01J18HZSACR1EMYNY1TBS8KTJD",
    "OwnerName":"Alex Smith",
    "Type":"IBAN",
    "Id":"bankacc_m_01J6A30MFXK50P8C8PCB73PM1B",
    "Tag":"Created using Mangopay API Postman Collection",
    "CreationDate":1654073079,
    "Active":true
}  

PHP

<?php 

require_once 'vendor/autoload.php';

use MangoPay\MangoPayApi;
use MangoPay\Libraries\ResponseException as MGPResponseException;
use MangoPay\Libraries\Exception as MGPException;

$api = new MangoPayApi();

$api->Config->ClientId = 'your-client-id';
$api->Config->ClientPassword = 'your-api-key';
$api->Config->TemporaryFolder = 'tmp/';

try {
    $userId = '146476890';
    $bankAccountId = '194612216';

    $response = $api->Users->GetBankAccount($userId, $bankAccountId);

    print_r($response);
} catch(MGPResponseException $e) {
    print_r($e);
} catch(MGPException $e) {
    print_r($e);
}