Skip to main content
POST
Verify account

Authorizations

Authorization
string
header
required

Use your account's Secret Key as the Bearer token.

Body

application/json
type
enum<string>
required

Verification type: NATURAL for individuals, SOLETRADER for self-employed, LEGAL for companies.

Available options:
NATURAL,
SOLETRADER,
LEGAL
first_name
string
required

First name of the account holder or representative.

Maximum string length: 255
last_name
string
required

Last name of the account holder or representative.

Maximum string length: 255
vat_id
string
required

Tax identification number (DNI, NIF, CIF, etc.).

Maximum string length: 255

Legal registered address.

Maximum string length: 255
Maximum string length: 255
Maximum string length: 255
Maximum string length: 255

Company legal name. Required for LEGAL type.

Maximum string length: 255

ISO 3166-1 alpha-2 country code.

Maximum string length: 2
birthday
string<date>

Date of birth. Applicable for NATURAL type.

occupation
string

Title or short description of occupation. Applicable for NATURAL type.

Maximum string length: 255
income_range
number

Income range value. Applicable for NATURAL type.

representative_name
string

Full name of the company representative. Required for LEGAL type.

Maximum string length: 255
representative_email
string<email>

Email of the company representative. Required for LEGAL type.

representative_phone
string

Phone of the company representative. Required for LEGAL type.

Response

Account verification submitted

self
string
Example:

"/2.0/accounts/me"

merchant_id
string

Unique merchant identifier (addon_key).

name
string
Example:

"My Company"

email
string<email>
currency
string
Example:

"EUR"

country_code
string
Example:

"ES"

business_url
string | null
business_phone
string | null
business_description
string | null
image_url
string | null
public_key
string
secret_key
string

Secret API key. Only visible to the account owner.

allow_shipping
enum<integer>
Available options:
0,
1
value_shipping
number
is_active
boolean
psd2_enabled
enum<integer>
Available options:
0,
1
allowed_gateways
string[]
gateways
object[] | null

List of configured payment gateway objects for the account.

default_gateway
string | null
created_at
string<date-time> | null