From 53889fc03c5ee139c03d3f20b9626773538365e2 Mon Sep 17 00:00:00 2001 From: Peng Ying Date: Tue, 14 Oct 2025 11:12:20 -0700 Subject: [PATCH 1/5] simplifying the payouts quickstart --- mintlify/payouts-and-b2b/quickstart.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/mintlify/payouts-and-b2b/quickstart.mdx b/mintlify/payouts-and-b2b/quickstart.mdx index 1c26815..3e57997 100644 --- a/mintlify/payouts-and-b2b/quickstart.mdx +++ b/mintlify/payouts-and-b2b/quickstart.mdx @@ -9,7 +9,11 @@ import KycUnregulated from '/snippets/kyc/kyc-unregulated.mdx'; This quickstart covers an example of sending a prefunded cross-border payout for a business customer on an unregulated platform. ## Get API credentials +<<<<<<< HEAD Create Sandbox API credentials in the dashboard, then set environment variables for local use. +======= + Create a Sandbox API credentialsin the dashboard, then set environment variables for local use. +>>>>>>> 8e0af17 (simplifying the payouts quickstart) ```bash export GRID_BASE_URL="https://api.lightspark.com/grid/2025-10-13" From fa59b3dec5ea140bf9e72293e6d80c8abc0b1208 Mon Sep 17 00:00:00 2001 From: Peng Ying Date: Wed, 15 Oct 2025 10:24:18 -0700 Subject: [PATCH 2/5] updating plaid callback to return pending external account --- mintlify/openapi.yaml | 18 ++---------------- openapi.yaml | 18 ++---------------- .../plaid_callback_{plaid_link_token}.yaml | 5 ++--- 3 files changed, 6 insertions(+), 35 deletions(-) diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index 8534a4c..222b65f 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -1221,12 +1221,11 @@ paths: responses: '202': description: | - Public token accepted and external account creation initiated. - The platform will receive a webhook notification when the external account is ready. + A pending external account resource will be created and returned while the Grid API asynchronously processes the Plaid public token. content: application/json: schema: - $ref: '#/components/schemas/PlaidCallbackResponse' + $ref: '#/components/schemas/ExternalAccount' '400': description: Bad request - Invalid public token or link token content: @@ -5460,19 +5459,6 @@ components: Optional Plaid account ID if the customer selected a specific account. If not provided, the default account will be used. example: plaid_account_id_123 - PlaidCallbackResponse: - type: object - required: - - message - properties: - message: - type: string - description: Human-readable message about the processing status - example: External account creation initiated. You will receive a webhook notification when complete. - requestId: - type: string - description: A unique identifier for this request, useful for debugging - example: req_abc123def456 Transaction: type: object required: diff --git a/openapi.yaml b/openapi.yaml index 8534a4c..222b65f 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -1221,12 +1221,11 @@ paths: responses: '202': description: | - Public token accepted and external account creation initiated. - The platform will receive a webhook notification when the external account is ready. + A pending external account resource will be created and returned while the Grid API asynchronously processes the Plaid public token. content: application/json: schema: - $ref: '#/components/schemas/PlaidCallbackResponse' + $ref: '#/components/schemas/ExternalAccount' '400': description: Bad request - Invalid public token or link token content: @@ -5460,19 +5459,6 @@ components: Optional Plaid account ID if the customer selected a specific account. If not provided, the default account will be used. example: plaid_account_id_123 - PlaidCallbackResponse: - type: object - required: - - message - properties: - message: - type: string - description: Human-readable message about the processing status - example: External account creation initiated. You will receive a webhook notification when complete. - requestId: - type: string - description: A unique identifier for this request, useful for debugging - example: req_abc123def456 Transaction: type: object required: diff --git a/openapi/paths/plaid/plaid_callback_{plaid_link_token}.yaml b/openapi/paths/plaid/plaid_callback_{plaid_link_token}.yaml index ae40fbb..965607d 100644 --- a/openapi/paths/plaid/plaid_callback_{plaid_link_token}.yaml +++ b/openapi/paths/plaid/plaid_callback_{plaid_link_token}.yaml @@ -33,12 +33,11 @@ post: responses: '202': description: | - Public token accepted and external account creation initiated. - The platform will receive a webhook notification when the external account is ready. + A pending external account resource will be created and returned while the Grid API asynchronously processes the Plaid public token. content: application/json: schema: - $ref: ../../components/schemas/plaid/PlaidCallbackResponse.yaml + $ref: ../../components/schemas/external_accounts/ExternalAccount.yaml '400': description: Bad request - Invalid public token or link token content: From a2264e298336d74b0dd14789a7fc3f14acafd632 Mon Sep 17 00:00:00 2001 From: Peng Ying Date: Wed, 15 Oct 2025 10:27:36 -0700 Subject: [PATCH 3/5] removing accidental change to quickstart --- mintlify/payouts-and-b2b/quickstart.mdx | 4 ---- 1 file changed, 4 deletions(-) diff --git a/mintlify/payouts-and-b2b/quickstart.mdx b/mintlify/payouts-and-b2b/quickstart.mdx index 3e57997..1c26815 100644 --- a/mintlify/payouts-and-b2b/quickstart.mdx +++ b/mintlify/payouts-and-b2b/quickstart.mdx @@ -9,11 +9,7 @@ import KycUnregulated from '/snippets/kyc/kyc-unregulated.mdx'; This quickstart covers an example of sending a prefunded cross-border payout for a business customer on an unregulated platform. ## Get API credentials -<<<<<<< HEAD Create Sandbox API credentials in the dashboard, then set environment variables for local use. -======= - Create a Sandbox API credentialsin the dashboard, then set environment variables for local use. ->>>>>>> 8e0af17 (simplifying the payouts quickstart) ```bash export GRID_BASE_URL="https://api.lightspark.com/grid/2025-10-13" From 148dc2148d2296922dea060c11974e6e045baa61 Mon Sep 17 00:00:00 2001 From: Peng Ying Date: Wed, 15 Oct 2025 11:05:59 -0700 Subject: [PATCH 4/5] updating the doc --- mintlify/snippets/plaid-integration.mdx | 27 +++++++++++++++++++++++-- 1 file changed, 25 insertions(+), 2 deletions(-) diff --git a/mintlify/snippets/plaid-integration.mdx b/mintlify/snippets/plaid-integration.mdx index 95800db..c1dc8ec 100644 --- a/mintlify/snippets/plaid-integration.mdx +++ b/mintlify/snippets/plaid-integration.mdx @@ -245,8 +245,31 @@ app.post('/api/plaid/exchange-token', async (req, res) => { ```json { - "message": "External account creation initiated. You will receive a webhook notification when complete.", - "requestId": "req_def456ghi789" + "id": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123", + "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001", + "status": "PENDING", + "platformAccountId": "user_123_primary_bank", + "currency": "USD", + "accountInfo": { + "accountType": "US_ACCOUNT", + "accountNumber": "123456789", + "routingNumber": "021000021", + "accountCategory": "CHECKING", + "bankName": "Chase Bank", + "beneficiary": { + "beneficiaryType": "INDIVIDUAL", + "fullName": "John Doe", + "birthDate": "1990-01-15", + "nationality": "US", + "address": { + "line1": "123 Main Street", + "city": "San Francisco", + "state": "CA", + "postalCode": "94105", + "country": "US" + } + } + } } ``` From c4077951c95c32a2c573d60a30d71a8159170372 Mon Sep 17 00:00:00 2001 From: Peng Ying Date: Wed, 29 Oct 2025 13:58:37 -0700 Subject: [PATCH 5/5] making accountInfo optional for plaid linking --- mintlify/openapi.yaml | 1 - mintlify/snippets/plaid-integration.mdx | 22 +------------------ openapi.yaml | 1 - .../external_accounts/ExternalAccount.yaml | 1 - .../schemas/plaid/PlaidCallbackResponse.yaml | 12 ---------- .../plaid_callback_{plaid_link_token}.yaml | 2 +- 6 files changed, 2 insertions(+), 37 deletions(-) delete mode 100644 openapi/components/schemas/plaid/PlaidCallbackResponse.yaml diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index 222b65f..9000fb5 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -5365,7 +5365,6 @@ components: - id - status - currency - - accountInfo properties: id: type: string diff --git a/mintlify/snippets/plaid-integration.mdx b/mintlify/snippets/plaid-integration.mdx index c1dc8ec..ba73e46 100644 --- a/mintlify/snippets/plaid-integration.mdx +++ b/mintlify/snippets/plaid-integration.mdx @@ -249,27 +249,7 @@ app.post('/api/plaid/exchange-token', async (req, res) => { "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001", "status": "PENDING", "platformAccountId": "user_123_primary_bank", - "currency": "USD", - "accountInfo": { - "accountType": "US_ACCOUNT", - "accountNumber": "123456789", - "routingNumber": "021000021", - "accountCategory": "CHECKING", - "bankName": "Chase Bank", - "beneficiary": { - "beneficiaryType": "INDIVIDUAL", - "fullName": "John Doe", - "birthDate": "1990-01-15", - "nationality": "US", - "address": { - "line1": "123 Main Street", - "city": "San Francisco", - "state": "CA", - "postalCode": "94105", - "country": "US" - } - } - } + "currency": "USD" } ``` diff --git a/openapi.yaml b/openapi.yaml index 222b65f..9000fb5 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -5365,7 +5365,6 @@ components: - id - status - currency - - accountInfo properties: id: type: string diff --git a/openapi/components/schemas/external_accounts/ExternalAccount.yaml b/openapi/components/schemas/external_accounts/ExternalAccount.yaml index 07a764c..9269cfc 100644 --- a/openapi/components/schemas/external_accounts/ExternalAccount.yaml +++ b/openapi/components/schemas/external_accounts/ExternalAccount.yaml @@ -4,7 +4,6 @@ allOf: - id - status - currency - - accountInfo properties: id: type: string diff --git a/openapi/components/schemas/plaid/PlaidCallbackResponse.yaml b/openapi/components/schemas/plaid/PlaidCallbackResponse.yaml deleted file mode 100644 index 3e3bfba..0000000 --- a/openapi/components/schemas/plaid/PlaidCallbackResponse.yaml +++ /dev/null @@ -1,12 +0,0 @@ -type: object -required: - - message -properties: - message: - type: string - description: Human-readable message about the processing status - example: External account creation initiated. You will receive a webhook notification when complete. - requestId: - type: string - description: A unique identifier for this request, useful for debugging - example: req_abc123def456 diff --git a/openapi/paths/plaid/plaid_callback_{plaid_link_token}.yaml b/openapi/paths/plaid/plaid_callback_{plaid_link_token}.yaml index 965607d..f35b73f 100644 --- a/openapi/paths/plaid/plaid_callback_{plaid_link_token}.yaml +++ b/openapi/paths/plaid/plaid_callback_{plaid_link_token}.yaml @@ -37,7 +37,7 @@ post: content: application/json: schema: - $ref: ../../components/schemas/external_accounts/ExternalAccount.yaml + $ref: ../../components/schemas/external_accounts/ExternalAccount.yaml '400': description: Bad request - Invalid public token or link token content: