Create a bank account

post

https://sb-api.xpollens.com/api/v1.1/users/{userid}/bankaccounts

Description

This endpoint is used in order to create and associate an external beneficiary account in order to perfom SCT Out operation. The BIC and IBAN should be used to create the bank account

Prerequisite

The BIC must be part of SEPA zone and IBAN should correspond the BIC country code.

Strong Customer Authentication: In order to perform the customer Strong Customer Authentication (mandatory and only for Agent partners), you must use this endpoint:

Post /api/sca/v1.1/users/{appuserid}/bankaccounts

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

userid

string

required

Body Params

Create Bank account

displayName

string

required

length ≥ 1

Last name and first name of beneficiary
As part of the verification of payee, the identity of the beneficiary is checked.
In order to limit the number of rejected transactions, it is essential that this information is accurate.

iban

string

required

length ≥ 1

IBAN (International Bank Account Number).

Parameter	Type	Format	Example	Description
Iban	string	X(34)	FR7630001007941234567890185	International Bank Account Number

bic

string | null

BIC (Bank Identifier Code). It is an 8 character code that identifies banks globally.

Parameter	Type	Format	Example	Description
Bic	string	X(8) or X(11)	SMOEFRP1XXX	Bank Identifier Code

firstName

string | null

First name

lastName

string | null

Last name

companyName

string | null

Company Name

zipCode

string | null

Zip code

string | null

phoneNumber

string | null

Phone number

Headers

CorrId

string

Defaults to 7f6f9a1a-7aa3-4ecf-8196-948a1c5ce6e0

Correlation Id

content-type

string

enum

Defaults to application/json-patch+json

Generated from available request content types

Allowed:

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Created

400Bad Request