Submit business verification

curl -X POST 'https://api.yativo.com/api/v1/card-checkout/customers/4f0c1e1a-8d2b-4c7e-9b1a-3e5f6a7b8c9d/verification' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Api-Secret: YOUR_API_SECRET' \
  -H 'Idempotency-Key: 2d8a1c4e-9f3b-4a7c-8e1d-6b5f0a2c9d11' \
  -H 'Content-Type: application/json' \
  -d '{
    "kind": "business",
    "business_name": "Acme LLC",
    "country": "US",
    "business_structure": "private_corporation"
  }'

{
  "status": "success",
  "status_code": 201,
  "message": "Verification submitted",
  "data": {
    "verification_status": "action_required",
    "information_requested": [
      {
        "id": "inrqi_01hxyz",
        "requirement": "business_verification_document",
        "type": "files",
        "label": "Company Verification Document",
        "options": [
          "<string>"
        ],
        "multiple": true,
        "optional": true,
        "files_allowed": true,
        "errors": "<string>"
      }
    ]
  }
}

{
  "status": "failed",
  "status_code": 403,
  "message": "<string>",
  "data": {
    "error": "Card checkout is not enabled for your account. Contact support to request access.",
    "code": "card_checkout_not_enabled"
  },
  "error": {
    "code": "invalid_argument",
    "message": "<string>",
    "request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
  },
  "error_details": {
    "code": "validation_error",
    "message": "The amount field is required.",
    "http_status": 422,
    "fields": {},
    "retryable": false,
    "retry_after": 123
  }
}

{
  "status": "failed",
  "status_code": 403,
  "message": "<string>",
  "data": {
    "error": "Card checkout is not enabled for your account. Contact support to request access.",
    "code": "card_checkout_not_enabled"
  },
  "error": {
    "code": "invalid_argument",
    "message": "<string>",
    "request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
  },
  "error_details": {
    "code": "validation_error",
    "message": "The amount field is required.",
    "http_status": 422,
    "fields": {},
    "retryable": false,
    "retry_after": 123
  }
}

{
  "status": "failed",
  "status_code": 403,
  "message": "<string>",
  "data": {
    "error": "Card checkout is not enabled for your account. Contact support to request access.",
    "code": "card_checkout_not_enabled"
  },
  "error": {
    "code": "invalid_argument",
    "message": "<string>",
    "request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
  },
  "error_details": {
    "code": "validation_error",
    "message": "The amount field is required.",
    "http_status": 422,
    "fields": {},
    "retryable": false,
    "retry_after": 123
  }
}

{
  "status": "failed",
  "status_code": 403,
  "message": "<string>",
  "data": {
    "error": "Card checkout is not enabled for your account. Contact support to request access.",
    "code": "card_checkout_not_enabled"
  },
  "error": {
    "code": "invalid_argument",
    "message": "<string>",
    "request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
  },
  "error_details": {
    "code": "validation_error",
    "message": "The amount field is required.",
    "http_status": 422,
    "fields": {},
    "retryable": false,
    "retry_after": 123
  }
}

{
  "status": "failed",
  "status_code": 403,
  "message": "<string>",
  "data": {
    "error": "Card checkout is not enabled for your account. Contact support to request access.",
    "code": "card_checkout_not_enabled"
  },
  "error": {
    "code": "invalid_argument",
    "message": "<string>",
    "request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
  },
  "error_details": {
    "code": "validation_error",
    "message": "The amount field is required.",
    "http_status": 422,
    "fields": {},
    "retryable": false,
    "retry_after": 123
  }
}

POST

card-checkout

customers

{customer_id}

verification

curl -X POST 'https://api.yativo.com/api/v1/card-checkout/customers/4f0c1e1a-8d2b-4c7e-9b1a-3e5f6a7b8c9d/verification' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Api-Secret: YOUR_API_SECRET' \
  -H 'Idempotency-Key: 2d8a1c4e-9f3b-4a7c-8e1d-6b5f0a2c9d11' \
  -H 'Content-Type: application/json' \
  -d '{
    "kind": "business",
    "business_name": "Acme LLC",
    "country": "US",
    "business_structure": "private_corporation"
  }'

{
  "status": "success",
  "status_code": 201,
  "message": "Verification submitted",
  "data": {
    "verification_status": "action_required",
    "information_requested": [
      {
        "id": "inrqi_01hxyz",
        "requirement": "business_verification_document",
        "type": "files",
        "label": "Company Verification Document",
        "options": [
          "<string>"
        ],
        "multiple": true,
        "optional": true,
        "files_allowed": true,
        "errors": "<string>"
      }
    ]
  }
}

{
  "status": "failed",
  "status_code": 403,
  "message": "<string>",
  "data": {
    "error": "Card checkout is not enabled for your account. Contact support to request access.",
    "code": "card_checkout_not_enabled"
  },
  "error": {
    "code": "invalid_argument",
    "message": "<string>",
    "request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
  },
  "error_details": {
    "code": "validation_error",
    "message": "The amount field is required.",
    "http_status": 422,
    "fields": {},
    "retryable": false,
    "retry_after": 123
  }
}

{
  "status": "failed",
  "status_code": 403,
  "message": "<string>",
  "data": {
    "error": "Card checkout is not enabled for your account. Contact support to request access.",
    "code": "card_checkout_not_enabled"
  },
  "error": {
    "code": "invalid_argument",
    "message": "<string>",
    "request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
  },
  "error_details": {
    "code": "validation_error",
    "message": "The amount field is required.",
    "http_status": 422,
    "fields": {},
    "retryable": false,
    "retry_after": 123
  }
}

{
  "status": "failed",
  "status_code": 403,
  "message": "<string>",
  "data": {
    "error": "Card checkout is not enabled for your account. Contact support to request access.",
    "code": "card_checkout_not_enabled"
  },
  "error": {
    "code": "invalid_argument",
    "message": "<string>",
    "request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
  },
  "error_details": {
    "code": "validation_error",
    "message": "The amount field is required.",
    "http_status": 422,
    "fields": {},
    "retryable": false,
    "retry_after": 123
  }
}

{
  "status": "failed",
  "status_code": 403,
  "message": "<string>",
  "data": {
    "error": "Card checkout is not enabled for your account. Contact support to request access.",
    "code": "card_checkout_not_enabled"
  },
  "error": {
    "code": "invalid_argument",
    "message": "<string>",
    "request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
  },
  "error_details": {
    "code": "validation_error",
    "message": "The amount field is required.",
    "http_status": 422,
    "fields": {},
    "retryable": false,
    "retry_after": 123
  }
}

{
  "status": "failed",
  "status_code": 403,
  "message": "<string>",
  "data": {
    "error": "Card checkout is not enabled for your account. Contact support to request access.",
    "code": "card_checkout_not_enabled"
  },
  "error": {
    "code": "invalid_argument",
    "message": "<string>",
    "request_id": "req_5f2c9a1e7b3d4c8a6e0f1b2d"
  },
  "error_details": {
    "code": "validation_error",
    "message": "The amount field is required.",
    "http_status": 422,
    "fields": {},
    "retryable": false,
    "retry_after": 123
  }
}

kind is always business. Any field you leave out is taken from prefill. Individual customers return 422 with code: use_onboarding_page. See Verify a business customer with your own form.

curl -X POST 'https://api.yativo.com/api/v1/card-checkout/customers/4f0c1e1a-8d2b-4c7e-9b1a-3e5f6a7b8c9d/verification' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Api-Secret: YOUR_API_SECRET' \
  -H 'Idempotency-Key: 2d8a1c4e-9f3b-4a7c-8e1d-6b5f0a2c9d11' \
  -H 'Content-Type: application/json' \
  -d '{
    "kind": "business",
    "business_name": "Acme LLC",
    "country": "US",
    "business_structure": "private_corporation"
  }'

Authorizations

X-Api-Key

string

header

required

Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.

X-Api-Secret

string

header

required

Your API secret (yativo_sk_...), shown once when the key is created.

Headers

Idempotency-Key

string

required

A unique string per request to ensure idempotent processing.

Path Parameters

customer_id

string

required

Body

application/json

kind

enum<string>

required

Always business. Individual customers add their ID and selfie on the onboarding page.

Available options:

business

business_name

string

Legal business name. Required unless prefilled.

country

string

Country of incorporation, ISO 3166-1 alpha-2. Required unless prefilled.

Required string length: 2

Example:

"US"

business_structure

string

Legal structure valid for country. Leave it out for countries without structures.

Example:

"private_corporation"

business_tax_identification_number

string

EIN (US), Business Number (CA), Company Number (UK).

place_of_incorporation

string

State or region of incorporation.

Example:

"DE"

business_website

string<uri>

address

object

Show child attributes

first_name

string

Business representative. Required unless prefilled.

last_name

string

Business representative. Required unless prefilled.

date_of_birth

string<date>

Representative's date of birth, YYYY-MM-DD, 18 or older.

tax_identification_number

string

Representative's personal tax ID. Sent once and not stored.

Response

Verification submitted

status

string

Example:

"success"

status_code

integer

Example:

201

message

string

Example:

"Verification submitted"

data

object

Show child attributes

Overview

Customers

Compliance RFIs

KYC / KYB

KYC Lookups

Payments & Transfers

Card Checkout

Deposits

Virtual Accounts

Wallets

Sandbox

Beneficiaries

Transactions

Virtual Cards

Payouts

Currency Swap

IP Whitelist

Corporate Cards

Corporate Card Transactions

Corporate Card Links

Webhooks

Developer

Submit business verification

Authorizations

Headers

Path Parameters

Body

Response