feat: add custody type and VASP link to external accounts

.stainless/stainless.yml

@@ -209,6 +209,7 @@ resources:
           external_account: '#/components/schemas/ExternalAccount'
           external_account_create: '#/components/schemas/ExternalAccountCreateRequest'
           external_account_info_one_of: "#/components/schemas/ExternalAccountInfoOneOf"
+          custody_type: "#/components/schemas/CustodyType"
           business_beneficiary: "#/components/schemas/BusinessBeneficiary"
           # Ownership verification (challenge/verify)
           ownership_verification_method: "#/components/schemas/OwnershipVerificationMethod"

openapi/components/schemas/errors/Error400.yaml

@@ -57,6 +57,7 @@ properties:
       | CARDHOLDER_KYC_NOT_APPROVED | The cardholder's KYC status is not `APPROVED`, so a card cannot be issued |
       | TRANSACTION_SIZE_LIMIT_EXCEEDED | The requested amount exceeds the configured maximum single-transaction amount for this trade corridor or withdrawal currency |
       | EXTERNAL_ACCOUNT_VERIFICATION_REQUIRED | The destination account's ownership must be verified before this transfer can proceed |
+      | COUNTERPARTY_USER_INFO_REQUIRED | The destination account needs beneficiary information before this transfer can proceed; update the external account with a `beneficiary` and retry |
     enum:
       - INVALID_INPUT
       - END_USER_TERMS_VERSION_NOT_FOUND
@@ -101,6 +102,7 @@ properties:
       - CARDHOLDER_KYC_NOT_APPROVED
       - TRANSACTION_SIZE_LIMIT_EXCEEDED
       - EXTERNAL_ACCOUNT_VERIFICATION_REQUIRED
+      - COUNTERPARTY_USER_INFO_REQUIRED
   message:
     type: string
     description: Error message

openapi/components/schemas/external_accounts/CustodyType.yaml

@@ -0,0 +1,12 @@
+type: string
+enum:
+  - SELF_CUSTODY
+  - VASP_HOSTED
+description: >-
+  How a crypto wallet external account is custodied: `SELF_CUSTODY` for a
+  wallet whose keys the owner controls directly, or `VASP_HOSTED` for an
+  account held at a Virtual Asset Service Provider (an exchange or other
+  custodial platform). Only relevant for crypto wallet accounts; defaults to
+  `SELF_CUSTODY`. Ownership verification applies only to `SELF_CUSTODY`
+  wallets — `VASP_HOSTED` accounts never require it.
+example: SELF_CUSTODY

openapi/components/schemas/external_accounts/ExternalAccount.yaml

@@ -24,6 +24,15 @@ allOf:
         example: acc_123456789
       ownershipType:
         $ref: ./OwnershipType.yaml
+      custodyType:
+        $ref: ./CustodyType.yaml
+      vaspName:
+        type: string
+        description: >-
+          Canonical name of the VASP that custodies this account, from the
+          VASP directory (`GET /vasps`). Only present when `custodyType` is
+          `VASP_HOSTED`.
+        example: Kraken
       currency:
         type: string
         description: The ISO 4217 currency code

openapi/components/schemas/external_accounts/ExternalAccountCreateRequest.yaml

@@ -20,6 +20,15 @@ allOf:
         example: ext_acc_123456
       ownershipType:
         $ref: ./OwnershipType.yaml
+      custodyType:
+        $ref: ./CustodyType.yaml
+      vaspName:
+        type: string
+        description: >-
+          Canonical name of the VASP that custodies this account, from the
+          VASP directory (`GET /vasps`). Required when `custodyType` is
+          `VASP_HOSTED`; must be omitted otherwise.
+        example: Kraken
       defaultUmaDepositAccount:
         type: boolean
         description: >-