From b29178b95dc45921966859ad25e981a79efc8c5d Mon Sep 17 00:00:00 2001 From: Jeremy Date: Thu, 6 Aug 2026 00:37:18 +0000 Subject: [PATCH] Add optional primary contact name to business info Businesses onboarding in regions that verify a named individual against the business (e.g. the EU) need to identify their registered director or authorised representative. Adds optional primaryContactFirstName / primaryContactLastName to the business info request, update, and response schemas; the customer's existing email and phoneNumber are that person's contact details. --- mintlify/openapi.yaml | 30 +++++++++++++++++++ openapi.yaml | 30 +++++++++++++++++++ .../schemas/customers/BusinessInfo.yaml | 14 +++++++++ .../customers/BusinessInfoResponse.yaml | 14 +++++++++ .../schemas/customers/BusinessInfoUpdate.yaml | 14 +++++++++ 5 files changed, 102 insertions(+) diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index 4d299878d..75833f86e 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -12613,6 +12613,16 @@ components: description: List of countries of the business's expected transaction counterparties (ISO 3166-1 alpha-2) example: - US + primaryContactFirstName: + type: string + maxLength: 250 + description: First name of the business's primary contact — a registered director or authorised representative of the business. Required in regions where a named individual is verified against the business during onboarding (e.g. the EU). The customer's `email` and `phoneNumber` are this person's contact details. + example: Jane + primaryContactLastName: + type: string + maxLength: 250 + description: Last name of the business's primary contact. + example: Smith BusinessCustomerFields: type: object required: @@ -12737,6 +12747,16 @@ components: description: List of countries of the business's expected transaction counterparties (ISO 3166-1 alpha-2) example: - US + primaryContactFirstName: + type: string + maxLength: 250 + description: First name of the business's primary contact — a registered director or authorised representative of the business. Required in regions where a named individual is verified against the business during onboarding (e.g. the EU). The customer's `email` and `phoneNumber` are this person's contact details. + example: Jane + primaryContactLastName: + type: string + maxLength: 250 + description: Last name of the business's primary contact. + example: Smith BeneficialOwnerRole: type: string enum: @@ -13080,6 +13100,16 @@ components: description: List of countries of the business's expected transaction counterparties (ISO 3166-1 alpha-2) example: - US + primaryContactFirstName: + type: string + maxLength: 250 + description: First name of the business's primary contact — a registered director or authorised representative of the business. Required in regions where a named individual is verified against the business during onboarding (e.g. the EU). The customer's `email` and `phoneNumber` are this person's contact details. + example: Jane + primaryContactLastName: + type: string + maxLength: 250 + description: Last name of the business's primary contact. + example: Smith BusinessCustomerCreateRequest: title: Business Customer Create Request allOf: diff --git a/openapi.yaml b/openapi.yaml index 4d299878d..75833f86e 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -12613,6 +12613,16 @@ components: description: List of countries of the business's expected transaction counterparties (ISO 3166-1 alpha-2) example: - US + primaryContactFirstName: + type: string + maxLength: 250 + description: First name of the business's primary contact — a registered director or authorised representative of the business. Required in regions where a named individual is verified against the business during onboarding (e.g. the EU). The customer's `email` and `phoneNumber` are this person's contact details. + example: Jane + primaryContactLastName: + type: string + maxLength: 250 + description: Last name of the business's primary contact. + example: Smith BusinessCustomerFields: type: object required: @@ -12737,6 +12747,16 @@ components: description: List of countries of the business's expected transaction counterparties (ISO 3166-1 alpha-2) example: - US + primaryContactFirstName: + type: string + maxLength: 250 + description: First name of the business's primary contact — a registered director or authorised representative of the business. Required in regions where a named individual is verified against the business during onboarding (e.g. the EU). The customer's `email` and `phoneNumber` are this person's contact details. + example: Jane + primaryContactLastName: + type: string + maxLength: 250 + description: Last name of the business's primary contact. + example: Smith BeneficialOwnerRole: type: string enum: @@ -13080,6 +13100,16 @@ components: description: List of countries of the business's expected transaction counterparties (ISO 3166-1 alpha-2) example: - US + primaryContactFirstName: + type: string + maxLength: 250 + description: First name of the business's primary contact — a registered director or authorised representative of the business. Required in regions where a named individual is verified against the business during onboarding (e.g. the EU). The customer's `email` and `phoneNumber` are this person's contact details. + example: Jane + primaryContactLastName: + type: string + maxLength: 250 + description: Last name of the business's primary contact. + example: Smith BusinessCustomerCreateRequest: title: Business Customer Create Request allOf: diff --git a/openapi/components/schemas/customers/BusinessInfo.yaml b/openapi/components/schemas/customers/BusinessInfo.yaml index 6c90887e2..9892a9f7e 100644 --- a/openapi/components/schemas/customers/BusinessInfo.yaml +++ b/openapi/components/schemas/customers/BusinessInfo.yaml @@ -105,3 +105,17 @@ properties: description: List of countries of the business's expected transaction counterparties (ISO 3166-1 alpha-2) example: - US + primaryContactFirstName: + type: string + maxLength: 250 + description: >- + First name of the business's primary contact — a registered director or + authorised representative of the business. Required in regions where a named + individual is verified against the business during onboarding (e.g. the EU). + The customer's `email` and `phoneNumber` are this person's contact details. + example: Jane + primaryContactLastName: + type: string + maxLength: 250 + description: Last name of the business's primary contact. + example: Smith diff --git a/openapi/components/schemas/customers/BusinessInfoResponse.yaml b/openapi/components/schemas/customers/BusinessInfoResponse.yaml index b5f1963bf..f97ed136a 100644 --- a/openapi/components/schemas/customers/BusinessInfoResponse.yaml +++ b/openapi/components/schemas/customers/BusinessInfoResponse.yaml @@ -106,3 +106,17 @@ properties: description: List of countries of the business's expected transaction counterparties (ISO 3166-1 alpha-2) example: - US + primaryContactFirstName: + type: string + maxLength: 250 + description: >- + First name of the business's primary contact — a registered director or + authorised representative of the business. Required in regions where a named + individual is verified against the business during onboarding (e.g. the EU). + The customer's `email` and `phoneNumber` are this person's contact details. + example: Jane + primaryContactLastName: + type: string + maxLength: 250 + description: Last name of the business's primary contact. + example: Smith diff --git a/openapi/components/schemas/customers/BusinessInfoUpdate.yaml b/openapi/components/schemas/customers/BusinessInfoUpdate.yaml index 27cb4551a..abf52fb16 100644 --- a/openapi/components/schemas/customers/BusinessInfoUpdate.yaml +++ b/openapi/components/schemas/customers/BusinessInfoUpdate.yaml @@ -101,3 +101,17 @@ properties: description: List of countries of the business's expected transaction counterparties (ISO 3166-1 alpha-2) example: - US + primaryContactFirstName: + type: string + maxLength: 250 + description: >- + First name of the business's primary contact — a registered director or + authorised representative of the business. Required in regions where a named + individual is verified against the business during onboarding (e.g. the EU). + The customer's `email` and `phoneNumber` are this person's contact details. + example: Jane + primaryContactLastName: + type: string + maxLength: 250 + description: Last name of the business's primary contact. + example: Smith