Create legal VA v2

post

https://sandbox-api-v2.dogpay.com/open-api/v1/va/legal-create-v2

Creates a new VA for a legal (corporate) entity. This endpoint supports the creation of both primary (first-level) and secondary (second-level) VAs.

👉 Business Account (VA) Onboarding

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

callId

string

required

length between 8 and 50

A client-provided unique string used to ensure idempotency and prevent duplicate processing of the same request.

name

string

required

VA name

route_id

string

Corresponding to the route_id issued by the supported-banks-v2 interface, if not passed, the country/bankName/currency/payeeType fields below will be used for route matching.
At least one of route_id and country/bankName/currency/payeeType must be provided.

currency

string

enum

Supported account currencies available for VA collection and receipt.

payeeType

string

enum

👉 Payee Type

Allowed:

country

string

enum

The list of supported countries or regions where a VA can be officially opened.

bankName

string

enum

VA Bank Name

tradeType

string

enum

required

👉 Trade Type

Allowed:

attachments

array of strings

required

A list of required attachment file IDs in UUID format (minimum 1, maximum 50 items).

Note: All files must be uploaded via the Upload Endpoint prior to calling this API.
Mandatory fileUseType values include:
- CORPORATE_RESOLUTION
- FATCA
- FINANCIAL_STATEMENTS
- BUSINESS_PROOF_OF_ADDRESS
- SOURCE_OF_FUNDS

attachments*

Headers

dgp-entity-id

string

Response

200