Skip to content

Commit 26233ab

Browse files
leonepariseleoneparise
authored
docs(guides): add KYC and KYB requirements guide (#22)
* docs(guides): add KYC and KYB requirements guide Documents the information and supporting documents required to onboard business and individual account owners, with extra sections for PSPs, crypto businesses, and non-resident entities. Wired into the Getting started sidebar group. * docs(guides): pad markdown table separators for MD060
1 parent 920e4cb commit 26233ab

2 files changed

Lines changed: 139 additions & 1 deletion

File tree

‎docs.json‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,8 @@
4646
"index",
4747
"quickstart",
4848
"guides/authentication",
49-
"guides/environments"
49+
"guides/environments",
50+
"guides/kyc-kyb"
5051
]
5152
},
5253
{

‎guides/kyc-kyb.mdx‎

Lines changed: 137 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,137 @@
1+
---
2+
title: "KYC and KYB requirements"
3+
description: "Information and documents required to onboard business and individual account owners."
4+
---
5+
6+
## Overview
7+
8+
Before an account can be activated, Trace FX must verify the identity of its owner and any beneficial owners. The verification model depends on the owner type:
9+
10+
- **KYB (Know Your Business)** applies to company-owned accounts (`owner.type = COMPANY`).
11+
- **KYC (Know Your Customer)** applies to individually-owned accounts (`owner.type = INDIVIDUAL`) and to every beneficial owner (UBO) registered on a company-owned account.
12+
13+
Information is submitted as structured fields on [`POST /api/accounts`](/api-reference/fx-account/accounts/create-account); supporting documents are uploaded against [`POST /api/documents`](/api-reference/fx-account/documents/upload-document) once the account exists. The exact document list varies per segment and per banking partner — the response from account creation returns the full `requirements.currentlyDue` list for your case.
14+
15+
## Details
16+
17+
### Business
18+
19+
Business onboarding covers companies that operate under one of the supported segments: standard companies (startups and PJs), payment service providers, crypto businesses, non-resident entities, funds, and exchange operators.
20+
21+
#### Common information for all business segments
22+
23+
These fields are submitted on the create-account request:
24+
25+
| Field | Format | Notes |
26+
| --- | --- | --- |
27+
| `owner.legalName` | string | Registered legal name on the company's incorporation document. |
28+
| `owner.taxId.value` | string | CNPJ for Brazilian companies; foreign tax identifier for non-residents. |
29+
| `owner.taxId.type` | enum | `CNPJ` for Brazilian companies; the corresponding type for non-residents. |
30+
| `owner.industry` | enum | Industry classification. See the [create-account schema](/api-reference/fx-account/accounts/create-account) for the full list. |
31+
| `owner.incorporateDate` | `yyyy-MM-dd` | Optional. Date of incorporation. |
32+
| `owner.address` | object | Full registered address (line 1, city, state, country, postal code). |
33+
34+
For each beneficial owner (UBO) registered via [`POST /api/accounts/{accountId}/ubos`](/api-reference/fx-account/beneficial-owners/add-ubo):
35+
36+
| Field | Format | Notes |
37+
| --- | --- | --- |
38+
| `name` | string | Full legal name. |
39+
| `taxId.value` / `taxId.type` | string / enum | CPF for Brazilian residents; foreign tax ID for non-residents. |
40+
| `address` | object | Residential address. |
41+
| `ownershipPercentage` | number | Optional. Percentage of ownership. |
42+
43+
#### Common documents for all business segments
44+
45+
These documents are required for every business segment:
46+
47+
- Articles of association, bylaws, or board-election minutes — registered and issued by the commercial registry (Junta Comercial in Brazil).
48+
- Articles of association of any corporate shareholder (PJ partner), if applicable.
49+
- Dated and signed organizational chart, if the corporate structure has multiple layers.
50+
- Annual revenue declaration, income statement (DRE), or balance sheet — signed by the accountant and the legal representative.
51+
52+
For each beneficial owner:
53+
54+
- Government-issued photo ID (RG, CNH, passport, RNM, or MRE) and tax ID (CPF for Brazilian residents).
55+
- Email address and phone number.
56+
- Proof of residence issued within the last 90 days (required by most partner banks).
57+
58+
#### Extra documents for payment service providers (PSPs)
59+
60+
PSPs (also referred to as "facilitadoras") aggregate or facilitate payments on behalf of merchants. In addition to the common business documents, partner banks require:
61+
62+
- AML/CTF policies, manuals, and registration forms.
63+
- A signed KYC form completed by the commercial officer.
64+
- A signed BaaS adhesion form, where applicable.
65+
- Operational details: number of employees, company website, and annual revenue.
66+
- A merchants record sheet listing the PSP's clients.
67+
- A PLD/FT (anti-money-laundering) policy in its current version.
68+
- A CDD (customer due diligence) questionnaire signed by the compliance officer.
69+
- Power of attorney and identity documents for any signatories acting on the company's behalf.
70+
71+
#### Extra documents for crypto businesses
72+
73+
Crypto businesses submit the standard business package plus:
74+
75+
- A signed KYC form completed by the commercial officer.
76+
- A signed BaaS adhesion form.
77+
- A crypto exposure questionnaire (CEQ).
78+
- Information on the exchanges and platforms used to operate.
79+
- Evidence of source of funds.
80+
- A description of the target audience, fundraising strategy, and marketing approach (for funds operating in crypto).
81+
82+
#### Extra documents for non-residents (CNR)
83+
84+
Non-resident entities (companies incorporated outside Brazil opening a CNR account) submit constitutional documents matching their legal form, all duly apostilled:
85+
86+
| Legal form | Required constitutional documents |
87+
| --- | --- |
88+
| Corporation (Corp. / Inc.) | Articles of Incorporation, Bylaws, Share Register |
89+
| Limited Liability Company (LLC) | Articles of Organization, Operating Agreement, Membership List |
90+
| Limited (Ltd) | Memorandum of Association + Certificate of Incorporation, Articles of Association, Register of Members / Shareholders |
91+
| Limited Liability Partnership (LLP) | Incorporation Document (UK) or Certificate of LLP (US), LLP Agreement, Register of Members |
92+
93+
In addition:
94+
95+
- Financial statements signed by the accountant and the legal representative.
96+
- Corporate organizational chart identifying ultimate beneficial owners.
97+
- AML/CTF policies.
98+
- Operating licenses, where the entity handles third-party funds.
99+
- Pre-approval from compliance: license, main merchants, and operational flow.
100+
- KYC form, due diligence form, and account-opening forms specific to the partner bank.
101+
- Power of attorney granting authority to a Brazilian legal representative, when the foreign representative does not hold a CPF.
102+
- Wolfsberg questionnaire, when the entity is a financial institution.
103+
104+
### Individuals
105+
106+
Individual onboarding covers natural persons opening a Trace FX account in their own name.
107+
108+
#### Common information for individuals
109+
110+
These fields are submitted on the create-account request:
111+
112+
| Field | Format | Notes |
113+
| --- | --- | --- |
114+
| `owner.firstName` | string | Given name. |
115+
| `owner.lastName` | string | Family name. |
116+
| `owner.taxId.value` | string | CPF for Brazilian residents; foreign tax identifier otherwise. |
117+
| `owner.taxId.type` | enum | `CPF` for Brazilian residents; the corresponding type otherwise. |
118+
| `owner.birthDate` | `yyyy-MM-dd` | Optional. Date of birth. |
119+
| `owner.address` | object | Full residential address (line 1, city, state, country, postal code). |
120+
121+
#### Common documents for individuals
122+
123+
- Government-issued photo ID — RG, CNH, passport, RNM, or MRE. Some partner banks require the document to have been issued within the last 10 years.
124+
- Proof of residence issued within the last 90 days.
125+
- Email address and phone number.
126+
- Marital status, and the spouse's full name and CPF when married.
127+
- Tax identification number (NIF or equivalent) in the country of fiscal residence, for non-Brazilian residents.
128+
- Proof of income — most recent income tax return, the last three pay stubs, or equivalent evidence.
129+
- Profession, employer name, monthly income, and net worth, where the partner bank requires it.
130+
- A FATCA form for individuals classified as foreign or with fiscal residence abroad.
131+
132+
## Related
133+
134+
- [Open multi-currency account](/journeys/open-multi-currency-account) — end-to-end flow that submits owner details, uploads documents, and registers UBOs.
135+
- [Create an account](/api-reference/fx-account/accounts/create-account) — request schema for company and individual owners.
136+
- [Upload a document](/api-reference/fx-account/documents/upload-document) — endpoint used to submit each required document.
137+
- [Add a UBO](/api-reference/fx-account/beneficial-owners/add-ubo) — register a beneficial owner for a company-owned account.

0 commit comments

Comments
 (0)