Sign in

v4

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-04-277127123.7 KB
Account

Verify account

Submits KYC (Know Your Customer) information for the authenticated account. Use NATURAL for individuals and LEGAL for companies. For LEGAL type, representative information is required.

post/accounts/verify

Request body

type'NATURAL' | 'SOLETRADER' | 'LEGAL' required

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

first_namestring required

First name of the account holder or representative.

last_namestring required

Last name of the account holder or representative.

vat_idstring required

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

legal_namestring

Company legal name. Required for LEGAL type.

legal_addressstring required

Legal registered address.

legal_citystring required
legal_zipstring required
legal_statestring required
legal_countrystring

ISO 3166-1 alpha-2 country code.

birthdaystring date

Date of birth. Applicable for NATURAL type.

occupationstring

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

income_rangenumber

Income range value. Applicable for NATURAL type.

representative_namestring

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

representative_emailstring email

Email of the company representative. Required for LEGAL type.

representative_phonestring

Phone of the company representative. Required for LEGAL type.

Example request

{
  "type": "LEGAL",
  "first_name": "John",
  "last_name": "Doe",
  "vat_id": "123456789",
  "legal_name": "My Company SL",
  "legal_address": "Llauder, 1",
  "legal_city": "Barcelona",
  "legal_zip": "08001",
  "legal_state": "Barcelona",
  "legal_country": "ES",
  "representative_name": "John Doe",
  "representative_email": "support@mycompany.com",
  "representative_phone": "+34666999666"
}

Response

Account verification submitted

selfstring
merchant_idstring

Unique merchant identifier (addon_key).

namestring
emailstring email
currencystring
country_codestring
business_urlstring nullable
business_phonestring nullable
business_descriptionstring nullable
image_urlstring nullable
public_keystring
secret_keystring

Secret API key. Only visible to the account owner.

allow_shipping0 | 1
value_shippingnumber
is_activeboolean
psd2_enabled0 | 1
allowed_gatewaysstring[]
gatewaysobject[] nullable

List of configured payment gateway objects for the account.

default_gatewaystring nullable
created_atstring date-time nullable

Example response

{
  "self": "/2.0/accounts/me",
  "name": "My Company",
  "currency": "EUR",
  "country_code": "ES"
}