From 2bd2e908ebf2303d07579091a4c40156e9fe4896 Mon Sep 17 00:00:00 2001 From: Victor Wu Date: Mon, 17 Aug 2026 10:01:23 -0700 Subject: [PATCH] feat: add bankAddress to USD funding payment instructions Wire senders often need the beneficiary bank's postal address, so add an optional bankAddress field to PaymentUsdAccountInfo. It sits on the payment shape rather than the shared UsdAccountInfoBase so it does not appear as an accepted-then-ignored input on USD external accounts. Co-Authored-By: Claude Opus 5 (1M context) --- mintlify/openapi.yaml | 6 ++++++ mintlify/snippets/internal-accounts.mdx | 6 ++++-- openapi.yaml | 6 ++++++ .../schemas/common/PaymentUsdAccountInfo.yaml | 10 ++++++++++ 4 files changed, 26 insertions(+), 2 deletions(-) diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml index c7b508c0a..c276df090 100644 --- a/mintlify/openapi.yaml +++ b/mintlify/openapi.yaml @@ -14632,6 +14632,12 @@ components: type: string description: Unique reference code that must be included with the payment to properly credit it example: UMA-Q12345-REF + bankAddress: + type: string + description: The postal address of the financial institution holding the account, on a single line. Optional on every rail, and recommended for wires, where some originating banks require the beneficiary institution's address before they will send. + example: 885 Teaneck Road, Teaneck, NJ 07666 + minLength: 1 + maxLength: 255 PaymentBrlAccountInfo: title: BRL Account allOf: diff --git a/mintlify/snippets/internal-accounts.mdx b/mintlify/snippets/internal-accounts.mdx index f0b392764..45618890c 100644 --- a/mintlify/snippets/internal-accounts.mdx +++ b/mintlify/snippets/internal-accounts.mdx @@ -84,7 +84,8 @@ curl -X GET 'https://api.lightspark.com/grid/2025-10-13/customers/internal-accou "accountNumber": "9876543210", "routingNumber": "021000021", "accountHolderName": "Lightspark Payments FBO John Doe", - "bankName": "JP Morgan Chase" + "bankName": "JP Morgan Chase", + "bankAddress": "270 Park Avenue, New York, NY 10017" } }, { @@ -145,7 +146,8 @@ Each internal account includes `fundingPaymentInstructions` that tell your custo "accountNumber": "9876543210", "routingNumber": "021000021", "accountHolderName": "Lightspark Payments FBO John Doe", - "bankName": "JP Morgan Chase" + "bankName": "JP Morgan Chase", + "bankAddress": "270 Park Avenue, New York, NY 10017" } } ``` diff --git a/openapi.yaml b/openapi.yaml index c7b508c0a..c276df090 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -14632,6 +14632,12 @@ components: type: string description: Unique reference code that must be included with the payment to properly credit it example: UMA-Q12345-REF + bankAddress: + type: string + description: The postal address of the financial institution holding the account, on a single line. Optional on every rail, and recommended for wires, where some originating banks require the beneficiary institution's address before they will send. + example: 885 Teaneck Road, Teaneck, NJ 07666 + minLength: 1 + maxLength: 255 PaymentBrlAccountInfo: title: BRL Account allOf: diff --git a/openapi/components/schemas/common/PaymentUsdAccountInfo.yaml b/openapi/components/schemas/common/PaymentUsdAccountInfo.yaml index e30410e23..cc9aec1f1 100644 --- a/openapi/components/schemas/common/PaymentUsdAccountInfo.yaml +++ b/openapi/components/schemas/common/PaymentUsdAccountInfo.yaml @@ -12,3 +12,13 @@ allOf: Unique reference code that must be included with the payment to properly credit it example: UMA-Q12345-REF + bankAddress: + type: string + description: >- + The postal address of the financial institution holding the account, on + a single line. Optional on every rail, and recommended for wires, where + some originating banks require the beneficiary institution's address + before they will send. + example: 885 Teaneck Road, Teaneck, NJ 07666 + minLength: 1 + maxLength: 255