From 8eabc35613d03a8d29a1b3fd6e5c5a49fe8a44c3 Mon Sep 17 00:00:00 2001 From: Jason Wang Date: Thu, 13 Aug 2026 17:40:28 -0700 Subject: [PATCH] docs: include businessType in the business-customer create examples MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `businessType` is optional to the schema, so none of the create examples set it — but receivers advertise their own mandatory sender fields, and GBP receivers require this one. A business that omits it passes KYB and then fails every GBP quote with MISSING_MANDATORY_USER_INFO, which reads as a corridor problem rather than a missing field. Adds it to the six business-customer create examples so the copy-paste path produces a customer that can actually pay. Co-Authored-By: Claude Opus 5 (1M context) --- .claude/skills/grid-api/SKILL.md | 5 ++++- mintlify/global-p2p/onboarding/configuring-customers.mdx | 3 ++- mintlify/ramps/onboarding/configuring-customers.mdx | 3 ++- mintlify/snippets/creating-customers/customers.mdx | 3 ++- mintlify/snippets/kyc/kyc-regulated.mdx | 3 ++- mintlify/snippets/kyc/kyc-unregulated.mdx | 3 ++- 6 files changed, 14 insertions(+), 6 deletions(-) diff --git a/.claude/skills/grid-api/SKILL.md b/.claude/skills/grid-api/SKILL.md index 0aec9aca..7036f524 100644 --- a/.claude/skills/grid-api/SKILL.md +++ b/.claude/skills/grid-api/SKILL.md @@ -165,6 +165,8 @@ curl -s -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \ # Create customer (BUSINESS) # businessInfo REQUIRES legalName, taxId, and incorporatedOn (ISO date YYYY-MM-DD). +# Always send businessType too: it's optional to the schema, but receivers can +# require it, and without it POST /quotes fails with MISSING_MANDATORY_USER_INFO. curl -s -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \ -X POST -H "Content-Type: application/json" \ -d '{ @@ -173,7 +175,8 @@ curl -s -u "$GRID_CLIENT_ID:$GRID_CLIENT_SECRET" \ "businessInfo": { "legalName": "Acme Corporation, Inc.", "taxId": "47-1234567", - "incorporatedOn": "2018-03-14" + "incorporatedOn": "2018-03-14", + "businessType": "INFORMATION" } }' \ "$GRID_BASE_URL/customers" | jq . diff --git a/mintlify/global-p2p/onboarding/configuring-customers.mdx b/mintlify/global-p2p/onboarding/configuring-customers.mdx index d0c79c89..c884b3d1 100644 --- a/mintlify/global-p2p/onboarding/configuring-customers.mdx +++ b/mintlify/global-p2p/onboarding/configuring-customers.mdx @@ -130,7 +130,8 @@ curl -sS -X POST "https://api.lightspark.com/grid/2025-10-13/customers" \ "legalName": "Acme Corporation", "registrationNumber": "789012345", "taxId": "123-45-6789", - "incorporatedOn": "2018-03-14" + "incorporatedOn": "2018-03-14", + "businessType": "INFORMATION" }, "address": { "line1": "456 Oak Avenue", diff --git a/mintlify/ramps/onboarding/configuring-customers.mdx b/mintlify/ramps/onboarding/configuring-customers.mdx index c96a7614..5d288ed7 100644 --- a/mintlify/ramps/onboarding/configuring-customers.mdx +++ b/mintlify/ramps/onboarding/configuring-customers.mdx @@ -74,7 +74,8 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers' \ "businessInfo": { "legalName": "Acme Corporation", "taxId": "12-3456789", - "incorporatedOn": "2018-03-14" + "incorporatedOn": "2018-03-14", + "businessType": "INFORMATION" }, "address": {...} }' diff --git a/mintlify/snippets/creating-customers/customers.mdx b/mintlify/snippets/creating-customers/customers.mdx index 722b513a..50d23a52 100644 --- a/mintlify/snippets/creating-customers/customers.mdx +++ b/mintlify/snippets/creating-customers/customers.mdx @@ -118,7 +118,8 @@ curl -sS -X POST "https://api.lightspark.com/grid/2025-10-13/customers" \ "legalName": "Acme Corporation", "registrationNumber": "789012345", "taxId": "123-45-6789", - "incorporatedOn": "2018-03-14" + "incorporatedOn": "2018-03-14", + "businessType": "INFORMATION" }, "address": { "line1": "456 Oak Avenue", diff --git a/mintlify/snippets/kyc/kyc-regulated.mdx b/mintlify/snippets/kyc/kyc-regulated.mdx index 11b3c02a..8b00235a 100644 --- a/mintlify/snippets/kyc/kyc-regulated.mdx +++ b/mintlify/snippets/kyc/kyc-regulated.mdx @@ -68,7 +68,8 @@ The examples below show a more comprehensive set of data. Not all fields are str "legalName": "Acme Corporation", "registrationNumber": "789012345", "taxId": "123-45-6789", - "incorporatedOn": "2018-03-14" + "incorporatedOn": "2018-03-14", + "businessType": "INFORMATION" }, "address": { "line1": "456 Oak Avenue", diff --git a/mintlify/snippets/kyc/kyc-unregulated.mdx b/mintlify/snippets/kyc/kyc-unregulated.mdx index 5fecc17a..ebaf31eb 100644 --- a/mintlify/snippets/kyc/kyc-unregulated.mdx +++ b/mintlify/snippets/kyc/kyc-unregulated.mdx @@ -241,7 +241,8 @@ The shape of the flow depends on the customer type: "legalName": "Acme Corporation", "registrationNumber": "789012345", "taxId": "123-45-6789", - "incorporatedOn": "2018-03-14" + "incorporatedOn": "2018-03-14", + "businessType": "INFORMATION" }, "address": { "line1": "456 Oak Avenue",