Submit Business Verification

Deprecated

This endpoint is deprecated. Use POST /v3/customers/{customer_id}/kyb to open the record, then PATCH /v3/customers/{customer_id}/kyb to write the business's details. It keeps working while integrations move; see Versioning.

This endpoint initiates the banking verification process for business accounts. It saves the business information but does not submit to the verification provider.

Takes a workspace-scoped API key. An account-scoped key is refused with 403.

Use the Request Business Verification endpoint to submit the verification to the provider.

The account must be in pending or needs_update status to submit verification data.

Authorization:

Every request is signed with your API key: a short-lived JWT, signed with your private key, sent in one header on /v3/* and /api/v2/* alike.

Headers:
  Authorization: APIKey {SIGNED_JWT}

How to build and sign the JWT: Authentication.

Endpoint

POST

/api/v2/kyb/banking-verification/business

Request Body Sample

{
  "accountId": "00000000-0000-0000-0000-000000000000",
  "name": "Acme Corporation",
  "dbaName": "Acme Corp",
  "phone": "+1234567890",
  "address": {
    "address1": "123 Business Ave",
    "address2": "Suite 500",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "US"
  },
  "idNumber": "123456789",
  "idDocumentType": "ein",
  "taxNumber": "123456789",
  "entityType": "corporation",
  "formationDate": "2021-12-31",
  "incorporationState": "NY",
  "website": "https://acme.example.com",
  "operationAddress": {
    "address1": "456 Operations Blvd",
    "city": "New York",
    "state": "NY",
    "postalCode": "10002",
    "country": "US"
  }
}

Request Body Schema

Field	Type	Description
accountId	string (uuid)	Required. The account ID to verify.
name	string	Required. Business name. Min 2, max 255 characters.
dbaName	string	Required. Doing business as name. Min 2, max 255 characters.
phone	string	Required. Phone number in E.164 format.
address	object	Required. Business address.
idNumber	string	Required. Business ID number (EIN).
idDocumentType	string	Required. ID document type. Only ein is accepted: another document type answers 400 kyb_id_document_type_unsupported, with details naming the field.
taxNumber	string	Required. Tax number.
entityType	string	Required. Entity type (e.g., corporation, llc, partnership, sole_proprietorship).
formationDate	string	Required. Formation date in YYYY-MM-DD format.
incorporationState	string	Required. State of incorporation.
website	string	Required. Business website URL.
operationAddress	object	Required. Operation address. Same schema as address.

Response Sample

{
  "accountId": "00000000-0000-0000-0000-000000000000",
  "status": "pending",
  "name": "Acme Corporation",
  "dbaName": "Acme Corp",
  "phone": "+1234567890",
  "address": {
    "address1": "123 Business Ave",
    "address2": "Suite 500",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "US"
  },
  "idNumber": "123456789",
  "idDocumentType": "ein",
  "taxNumber": "123456789",
  "entityType": "corporation",
  "formationDate": "2021-12-31",
  "incorporationState": "NY",
  "website": "https://acme.example.com",
  "operationAddress": {
    "address1": "456 Operations Blvd",
    "city": "New York",
    "state": "NY",
    "postalCode": "10002",
    "country": "US"
  },
  "owners": [],
  "verificationFiles": [],
  "eventHistory": [],
  "createdAt": "2023-01-01T00:00:00Z",
  "updatedAt": "2023-01-01T00:00:00Z"
}

Support and Resources

If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.

Stay Updated

Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:

• Instagram: BlockWyre Instagram
• Twitter: BlockWyre Twitter
• Facebook: BlockWyre Facebook
• LinkedIn: BlockWyre LinkedIn

We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!