---
title: "Request Corporate and User Subaccount"
method: POST
path: "/payaza-account/api/v1/subaccounts/merchant/euro/request"
tags: ["EUR Accounts"]
---

# Request Corporate and User Subaccount

`POST /payaza-account/api/v1/subaccounts/merchant/euro/request`

This endpoint allows users to create a corporate or user subaccount

## Request body

- union
  - CorporateSubAccountRequest
    - `country` string, required — The 2-letter ISO country code (e.g.US.)
    - `purpose` string, required — The purpose for opening the account.
    - `currency` string, required — The currency code e.g. **EUR**.
    - `category` string, required — The category of the account.
    - `certificate_of_incorporation` string, uri, required — URL link to the certificate of incorporation.
    - `mermat` string, uri — URL link to company memorandum and articles of association.
    - `consent` boolean, required — Whether the company consents to the account request.
    - `account_type` string, required — Type of account **(corporate)**.
    - `main_account_payaza_reference` string, required — The main Payaza account reference number.
    - `company_name` string, required — The registered company name.
    - `directors` object[], required — List of directors with identification and proof of address.
      - `id_file` string, uri, required — URL to the director's ID document.
      - `id_type` string, required — Type of ID provided (e.g., passport).
      - `poa_file` string, uri, required — URL to the Proof of Address document.
      - `poa_type` string, required — Type of POA provided (e.g., utilityBill).
    - `shareholders` object[] — List of company shareholders (Optional).
      - `id_file` string, uri, required — URL to the shareholder's ID document.
      - `id_type` string, required — Type of ID provided.
      - `poa_file` string, uri, required — URL to the shareholder's Proof of Address.
      - `poa_type` string, required — Type of POA provided.
  - UserSubAccountRequest
    - `country` string, required — The country ISO code **(e.g. US)**
    - `currency` string, required — The currency code **(e.g. EUR)**.
    - `category` string, required — The category of the account.
    - `purpose` string, required — Purpose of account.
    - `consent` boolean, required — Consent confirmation.
    - `account_type` string, required — Type of account (**user**).
    - `main_account_payaza_reference` string, required — The main Payaza account reference.
    - `id_file` string, uri, required — URL link to the user's ID document.
    - `id_type` string, required — User’s ID type (**passport** or **identityCard**)..
    - `poa_file` string, uri, required — URL link to the Proof of Address document.
    - `poa_type` string — Type of proof of address (e.g. utilityBill)
    - `first_name` string, required — First name of the user.
    - `last_name` string, required — Last name of the user.

## Response `200`

Sub-account requested

- RequestSubAccountResponse
  - `message` string — Response message.
  - `status` boolean — Request status.
  - `creationReference` string — Unique reference ID to track the status of the review.

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/payaza/apis/payaza-documentation.md) · [All operations](https://skmtc.net/payaza/apis/payaza-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payaza/payaza-documentation/revisions/1ecd4b94ff07/schema)