From cc516cb2ebb5bc09a1768238583c5d0c65a3665b Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Thu, 20 Aug 2026 08:17:21 +0000 Subject: [PATCH] docs: sync documentation with recent OpenAPI schema changes - Add COLLECTION_FAILED to incoming payment failure reasons in error handling guide - Document INTERNAL_ACCOUNT.FUNDING_INSTRUCTIONS_UPDATED webhook for internal accounts - Add note pointing to recommended client-held-key flow in session refresh docs Co-Authored-By: Claude Opus 4.5 --- mintlify/snippets/error-handling.mdx | 1 + mintlify/snippets/global-accounts/managing-sessions.mdx | 4 ++++ mintlify/snippets/internal-accounts.mdx | 2 +- 3 files changed, 6 insertions(+), 1 deletion(-) diff --git a/mintlify/snippets/error-handling.mdx b/mintlify/snippets/error-handling.mdx index 9e7173bd1..bdd3d696c 100644 --- a/mintlify/snippets/error-handling.mdx +++ b/mintlify/snippets/error-handling.mdx @@ -231,6 +231,7 @@ When a transaction fails, the `failureReason` field provides specific details: - `PAYMENT_APPROVAL_WEBHOOK_ERROR` - Webhook returned an error - `OFFRAMP_FAILED` - Failed to convert and send funds to destination - `QUOTE_EXPIRED` - Quote expired during processing +- `COLLECTION_FAILED` - Inbound bank-rail collection deposit failed after arrival and did not credit; funds returned to sender ## Handling failures diff --git a/mintlify/snippets/global-accounts/managing-sessions.mdx b/mintlify/snippets/global-accounts/managing-sessions.mdx index 8f03b14b4..d3015d571 100644 --- a/mintlify/snippets/global-accounts/managing-sessions.mdx +++ b/mintlify/snippets/global-accounts/managing-sessions.mdx @@ -40,6 +40,10 @@ The list endpoint returns all **active** sessions; expired sessions are not incl Session refresh creates a new session signing key from an existing active session. Use this when the customer is still present and the current session is close to expiration. If the session has already expired, reauthenticate with the original credential instead. + + The examples below show the legacy flow with `encryptedSessionSigningKey`. For new integrations, use the recommended [client-held-key flow](/snippets/global-accounts/client-keys#client-held-session-key) by sending a compressed `clientPublicKey` (66 hex characters), which avoids the decrypt step entirely. + + ```bash diff --git a/mintlify/snippets/internal-accounts.mdx b/mintlify/snippets/internal-accounts.mdx index 45618890c..7ec4f5c5c 100644 --- a/mintlify/snippets/internal-accounts.mdx +++ b/mintlify/snippets/internal-accounts.mdx @@ -371,7 +371,7 @@ Show the payment details prominently in your UI: Set up webhook listeners to receive notifications when deposits are credited to the internal account. The account balance will update automatically. -You'll receive `INTERNAL_ACCOUNT.BALANCE_UPDATED` webhook events when the internal account balance changes. +You'll receive `INTERNAL_ACCOUNT.BALANCE_UPDATED` webhook events when the internal account balance changes, and `INTERNAL_ACCOUNT.FUNDING_INSTRUCTIONS_UPDATED` when funding instructions are added or modified.