Skip to main content
POST
/
accounts
/
verify
Verify account
curl --request POST \
  --url https://api.truust.io/2.0/accounts/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
}
'
{
  "self": "/2.0/accounts/me",
  "merchant_id": "<string>",
  "name": "My Company",
  "email": "jsmith@example.com",
  "currency": "EUR",
  "country_code": "ES",
  "business_url": "<string>",
  "business_phone": "<string>",
  "business_description": "<string>",
  "image_url": "<string>",
  "public_key": "<string>",
  "secret_key": "<string>",
  "allow_shipping": 0,
  "value_shipping": 123,
  "is_active": true,
  "psd2_enabled": 0,
  "allowed_gateways": [
    "<string>"
  ],
  "gateways": [
    {}
  ],
  "default_gateway": "<string>",
  "created_at": "2023-11-07T05:31:56Z"
}

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_address
string
required

Legal registered address.

Maximum string length: 255
​
legal_city
string
required
Maximum string length: 255
​
legal_zip
string
required
Maximum string length: 255
​
legal_state
string
required
Maximum string length: 255
​
legal_name
string

Company legal name. Required for LEGAL type.

Maximum string length: 255
​
legal_country
string

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