From 58d582733b9b2ba529f2943231d48bd271ccfd95 Mon Sep 17 00:00:00 2001 From: Ethan Du Date: Thu, 17 Sep 2026 18:14:24 -0700 Subject: [PATCH] feat: add expected jurisdiction EDD fields to individual customers Add `expectedRecipientJurisdictions` and `expectedTransactionJurisdictions` to `CustomerEdd`, so individual customers carry the same forward-looking geography that business customers already have. Co-Authored-By: Claude Opus 5 --- mintlify/openapi.yaml | 14 ++++++++++++++ .../snippets/kyc/customer-data-requirements.mdx | 2 +- openapi.yaml | 14 ++++++++++++++ .../schemas/customers/CustomerEdd.yaml | 16 ++++++++++++++++ 4 files changed, 45 insertions(+), 1 deletion(-) diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index 394c67c04..ab7c6b2dc 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -13988,6 +13988,20 @@ components: $ref: '#/components/schemas/ExpectedMonthlyTransactionCount' expectedMonthlyTransactionVolume: $ref: '#/components/schemas/ExpectedMonthlyTransactionVolume' + expectedRecipientJurisdictions: + type: array + items: + type: string + description: List of countries where the customer expects to send payments (ISO 3166-1 alpha-2) + example: + - US + expectedTransactionJurisdictions: + type: array + items: + type: string + description: List of countries the customer's transactions are expected to involve, in either direction (ISO 3166-1 alpha-2) + example: + - US annualIncomeRange: $ref: '#/components/schemas/AnnualIncomeRange' netWorthRange: diff --git a/mintlify/snippets/kyc/customer-data-requirements.mdx b/mintlify/snippets/kyc/customer-data-requirements.mdx index ec8b83ed6..f0d7b6212 100644 --- a/mintlify/snippets/kyc/customer-data-requirements.mdx +++ b/mintlify/snippets/kyc/customer-data-requirements.mdx @@ -24,7 +24,7 @@ Documents, uploaded via `POST /documents` — identity documents also require `d - **Identity document** — a `PASSPORT` (single image), or a `DRIVERS_LICENSE` / `NATIONAL_ID` uploaded as separate `FRONT` and `BACK` images via the `side` field. - **Proof of address** — requested in some jurisdictions and for some currencies. Any of `UTILITY_BILL`, `ELECTRICITY_BILL`, `RENT_OR_LEASE_AGREEMENT`, `BANK_STATEMENT`, or `TAX_RETURN`, dated within the last 3 months. -Some jurisdictions, flows, and volume tiers also require enhanced due diligence. These are optional top-level fields on the individual customer — `sourceOfFundsCategories`, `sourceOfWealthCategories`, `purposeOfAccount`, `expectedMonthlyTransactionCount`, `expectedMonthlyTransactionVolume`, `annualIncomeRange`, `netWorthRange`, and `pepStatus`. The provider decides which apply; you learn which ones through `MISSING_FIELD` errors on `POST /verifications` rather than up front. Each `*Categories` field that includes `OTHER` also requires its matching `*OtherDescription`. +Some jurisdictions, flows, and volume tiers also require enhanced due diligence. These are optional top-level fields on the individual customer — `sourceOfFundsCategories`, `sourceOfWealthCategories`, `purposeOfAccount`, `expectedMonthlyTransactionCount`, `expectedMonthlyTransactionVolume`, `expectedRecipientJurisdictions`, `expectedTransactionJurisdictions`, `annualIncomeRange`, `netWorthRange`, and `pepStatus`. The provider decides which apply; you learn which ones through `MISSING_FIELD` errors on `POST /verifications` rather than up front. Each `*Categories` field that includes `OTHER` also requires its matching `*OtherDescription`. ### KYB — business customers diff --git a/openapi.yaml b/openapi.yaml index 394c67c04..ab7c6b2dc 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -13988,6 +13988,20 @@ components: $ref: '#/components/schemas/ExpectedMonthlyTransactionCount' expectedMonthlyTransactionVolume: $ref: '#/components/schemas/ExpectedMonthlyTransactionVolume' + expectedRecipientJurisdictions: + type: array + items: + type: string + description: List of countries where the customer expects to send payments (ISO 3166-1 alpha-2) + example: + - US + expectedTransactionJurisdictions: + type: array + items: + type: string + description: List of countries the customer's transactions are expected to involve, in either direction (ISO 3166-1 alpha-2) + example: + - US annualIncomeRange: $ref: '#/components/schemas/AnnualIncomeRange' netWorthRange: diff --git a/openapi/components/schemas/customers/CustomerEdd.yaml b/openapi/components/schemas/customers/CustomerEdd.yaml index c3735be20..37f830bbd 100644 --- a/openapi/components/schemas/customers/CustomerEdd.yaml +++ b/openapi/components/schemas/customers/CustomerEdd.yaml @@ -52,6 +52,22 @@ properties: $ref: ./ExpectedMonthlyTransactionCount.yaml expectedMonthlyTransactionVolume: $ref: ./ExpectedMonthlyTransactionVolume.yaml + expectedRecipientJurisdictions: + type: array + items: + type: string + description: List of countries where the customer expects to send payments (ISO 3166-1 alpha-2) + example: + - US + expectedTransactionJurisdictions: + type: array + items: + type: string + description: >- + List of countries the customer's transactions are expected to involve, in + either direction (ISO 3166-1 alpha-2) + example: + - US annualIncomeRange: $ref: ./AnnualIncomeRange.yaml netWorthRange: