dutchman-bridge 1.0.0 → 1.1.0

package/README.md

@@ -11,20 +11,14 @@ and response is typed, and it is regenerated whenever the API changes.
 
 ## Install
 
-The package is distributed from a private GitHub repository you have been given read
-access to. Pin a tag in your `package.json`:
-
-```json
-{
-  "dependencies": {
-    "dutchman-bridge": "github:Dutchman-io/dutchman-bridge-sdk#v1.0.0"
-  }
-}
+```bash
+npm install dutchman-bridge
 ```
 
-or `npm install github:Dutchman-io/dutchman-bridge-sdk#v1.0.0`. npm needs credentials
-that can read the repository — an SSH key or a `GITHUB_TOKEN`/git credential helper on
-the machine running the install (including CI).
+Published on the public npm registry. To pin the exact generated source instead, a
+git dependency on a release tag also works:
+`"dutchman-bridge": "github:Dutchman-io/dutchman-bridge-sdk#v1.0.0"` (needs read
+access to the repository).
 
 ## Configure
 
@@ -144,6 +138,32 @@ do {
 } while (cursor);
 ```
 
+## Retrying safely
+
+Every call that moves money takes an optional `reference` — your own request id.
+Send the same value again and you get the original record back; nothing moves
+twice.
+
+```ts
+await bridge.wallet.withdraw({
+  path: { customerId },
+  body: { amount: 50000, reference: 'req_01HZY4K8N2' },
+});
+```
+
+It is accepted by `wallet.withdraw`, `send.submit`, `wallet.initiateFundingCharge`
+and `globalSend.initiate`. Letters, digits, dot, underscore and hyphen; 120
+characters max. It is scoped per endpoint, so the same value on a withdrawal and
+on a send are two different records — choose one per intended operation (a
+request id, not a customer id).
+
+**A timeout is not a failure.** If a call times out or answers 5xx, retry it with
+the same `reference` rather than assuming nothing happened — that is the only way
+to find out which. Without one, a retry is a second withdrawal.
+
+Buy and sell are covered by their quote instead: a `quoteId` executes exactly
+once, including when two requests arrive together.
+
 ## Errors
 
 On a non-2xx status `error` is the parsed JSON body and `data` is `undefined`. The API

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { client, type CreateClientConfig } from './client.gen';
 export { Bank, Countries, Customers, DutchmanBridge, Features, GlobalSend, Kyc, type Options, Profile, Ramp, Receiving, Send, Wallet, Webhook } from './sdk.gen';
-export type { AddAccountDto, BankAddAccountData, BankAddAccountResponse, BankAddAccountResponses, BankBanksData, BankBanksResponse, BankBanksResponses, BankDeleteAccountData, BankDeleteAccountResponse, BankDeleteAccountResponses, BankGetAccountsData, BankGetAccountsResponse, BankGetAccountsResponses, BankSetDefaultAccountData, BankSetDefaultAccountResponse, BankSetDefaultAccountResponses, BankVerifyAccountData, BankVerifyAccountResponse, BankVerifyAccountResponses, BlockchainNetwork, CheckSelfieDto, ClientOptions, CountriesListData, CountriesListResponse, CountriesListResponses, CustomerSellDto, CustomersFullData, CustomersFullResponse, CustomersFullResponses, CustomersGetData, CustomersGetResponse, CustomersGetResponses, CustomersRegisterData, CustomersRegisterResponse, CustomersRegisterResponses, FeaturesListData, FeaturesListResponse, FeaturesListResponses, FeatureStatus, FundingChargeStatus, GetQuoteDto, GlobalSendBeneficiaryDto, GlobalSendCorridorsData, GlobalSendCorridorsResponse, GlobalSendCorridorsResponses, GlobalSendInitiateData, GlobalSendInitiateResponse, GlobalSendInitiateResponses, GlobalSendQuoteData, GlobalSendQuoteDto, GlobalSendQuoteResponse, GlobalSendQuoteResponses, GlobalSendVerificationStatusData, GlobalSendVerificationStatusResponse, GlobalSendVerificationStatusResponses, InitiateFundingChargeDto, InitiateGlobalSendDto, KycDocumentData, KycDocumentResponse, KycDocumentResponses, KycReverificationData, KycReverificationResponse, KycReverificationResponses, KycSelfieCheckRouteData, KycSelfieCheckRouteResponse, KycSelfieCheckRouteResponses, KycStatus, KycStatusData, KycStatusResponse, KycStatusResponses, KycTier1Data, KycTier1Response, KycTier1Responses, KycTier2Data, KycTier2Response, KycTier2Responses, KycTier3Data, KycTier3Response, KycTier3Responses, LedgerEntryType, PartnerAccountVerificationDto, PartnerBalanceDto, PartnerBankAccountDto, PartnerBankDto, PartnerBuyResultDto, PartnerCorridorDto, PartnerCountryDto, PartnerCustomerDto, PartnerCustomerKycSnapshotDto, PartnerCustomerSnapshotDto, PartnerCustomerWalletSnapshotDto, PartnerDepositAddressDto, PartnerFeatureDto, PartnerFundingChargeDto, PartnerGlobalSendQuoteDto, PartnerGlobalSendResultDto, PartnerKycRecordDto, PartnerKycSubmissionDto, PartnerLedgerEntryDto, PartnerNetworkDto, PartnerRampQuoteDto, PartnerRateDto, PartnerReceivingAccountDto, PartnerReceivingActivityDto, PartnerReverificationRequestDto, PartnerSelfieCheckDto, PartnerSellResultDto, PartnerSendNetworkDto, PartnerSendQuoteDto, PartnerSendResultDto, PartnerSettlementModeDto, PartnerUploadedDocumentDto, PartnerVerificationRecordDto, PartnerVirtualAccountDto, PartnerWebhookConfigDto, PartnerWebhookDeliveryDetailDto, PartnerWebhookDeliveryDto, PartnerWebhookSecretDto, PartnerWebhookTestDto, PartnerWithdrawalBankAccountDto, PartnerWithdrawalDto, ProfileChangePasswordData, ProfileChangePasswordResponse, ProfileChangePasswordResponses, ProfileDeleteAccountData, ProfileDeleteAccountResponse, ProfileDeleteAccountResponses, ProfileGetSettlementModeData, ProfileGetSettlementModeResponse, ProfileGetSettlementModeResponses, ProfileProfileData, ProfileProfileResponse, ProfileProfileResponses, ProfileSetSettlementModeData, ProfileSetSettlementModeResponse, ProfileSetSettlementModeResponses, ProfileUpdateProfileData, ProfileUpdateProfileResponse, ProfileUpdateProfileResponses, ProfileWithdrawalsData, ProfileWithdrawalsResponse, ProfileWithdrawalsResponses, QuoteSendDto, RampBuyData, RampBuyQuoteData, RampBuyQuoteResponse, RampBuyQuoteResponses, RampBuyResponse, RampBuyResponses, RampRateData, RampRateResponse, RampRateResponses, RampSellData, RampSellNetworksData, RampSellNetworksResponse, RampSellNetworksResponses, RampSellQuoteData, RampSellQuoteResponse, RampSellQuoteResponses, RampSellResponse, RampSellResponses, ReceivingActivityData, ReceivingActivityResponse, ReceivingActivityResponses, ReceivingCurrenciesData, ReceivingCurrenciesResponse, ReceivingCurrenciesResponses, ReceivingListData, ReceivingListResponse, ReceivingListResponses, ReceivingOpenData, ReceivingOpenResponse, ReceivingOpenResponses, ReceivingRefreshData, ReceivingRefreshResponse, ReceivingRefreshResponses, RegisterCustomerDto, ResetPassword, ReverificationItem, ReverificationStatus, SendDto, SendNetworksData, SendNetworksResponse, SendNetworksResponses, SendQuoteData, SendQuoteResponse, SendQuoteResponses, SendSubmitData, SendSubmitResponse, SendSubmitResponses, SettlementMode, SettlementModeDto, SetWebhookUrlDto, SubmitTier3Dto, Tier1KycDto, Tier2KycDto, UpdateCustomerProfileDto, VerifyAccountNumberInput, WalletAddressesData, WalletAddressesResponse, WalletAddressesResponses, WalletBalanceData, WalletBalanceResponse, WalletBalanceResponses, WalletFundingChargesData, WalletFundingChargesResponse, WalletFundingChargesResponses, WalletInitiateFundingChargeData, WalletInitiateFundingChargeResponse, WalletInitiateFundingChargeResponses, WalletStreamBalanceData, WalletStreamBalanceResponses, WalletTransactionsData, WalletTransactionsResponse, WalletTransactionsResponses, WalletVirtualAccountForData, WalletVirtualAccountForResponse, WalletVirtualAccountForResponses, WalletWithdrawData, WalletWithdrawResponse, WalletWithdrawResponses, WebhookConfigData, WebhookConfigResponse, WebhookConfigResponses, WebhookDeliveriesData, WebhookDeliveriesResponse, WebhookDeliveriesResponses, WebhookDeliveryData, WebhookDeliveryResponse, WebhookDeliveryResponses, WebhookDeliveryStatus, WebhookReplayData, WebhookReplayResponse, WebhookReplayResponses, WebhookRotateSecretData, WebhookRotateSecretResponse, WebhookRotateSecretResponses, WebhookSetUrlData, WebhookSetUrlResponse, WebhookSetUrlResponses, WithdrawalStatus, WithdrawDto } from './types.gen';
+export type { AddAccountDto, BankAddAccountData, BankAddAccountResponse, BankAddAccountResponses, BankBanksData, BankBanksResponse, BankBanksResponses, BankDeleteAccountData, BankDeleteAccountResponse, BankDeleteAccountResponses, BankGetAccountsData, BankGetAccountsResponse, BankGetAccountsResponses, BankSetDefaultAccountData, BankSetDefaultAccountResponse, BankSetDefaultAccountResponses, BankVerifyAccountData, BankVerifyAccountResponse, BankVerifyAccountResponses, BlockchainNetwork, CheckSelfieDto, ClientOptions, CountriesListData, CountriesListResponse, CountriesListResponses, CustomerSellDto, CustomersFullData, CustomersFullResponse, CustomersFullResponses, CustomersGetData, CustomersGetResponse, CustomersGetResponses, CustomersRegisterData, CustomersRegisterResponse, CustomersRegisterResponses, FeaturesListData, FeaturesListResponse, FeaturesListResponses, FeatureStatus, FundingChargeStatus, GetQuoteDto, GlobalSendBeneficiaryDto, GlobalSendCorridorsData, GlobalSendCorridorsResponse, GlobalSendCorridorsResponses, GlobalSendInitiateData, GlobalSendInitiateResponse, GlobalSendInitiateResponses, GlobalSendQuoteData, GlobalSendQuoteDto, GlobalSendQuoteResponse, GlobalSendQuoteResponses, GlobalSendVerificationStatusData, GlobalSendVerificationStatusResponse, GlobalSendVerificationStatusResponses, InitiateFundingChargeDto, InitiateGlobalSendDto, KycDocumentData, KycDocumentResponse, KycDocumentResponses, KycReverificationData, KycReverificationResponse, KycReverificationResponses, KycSelfieCheckRouteData, KycSelfieCheckRouteResponse, KycSelfieCheckRouteResponses, KycStatus, KycStatusData, KycStatusResponse, KycStatusResponses, KycSummaryData, KycSummaryResponse, KycSummaryResponses, KycTier1Data, KycTier1Response, KycTier1Responses, KycTier2Data, KycTier2Response, KycTier2Responses, KycTier3Data, KycTier3Response, KycTier3Responses, LedgerEntryType, PartnerAccountVerificationDto, PartnerBalanceDto, PartnerBankAccountDto, PartnerBankDto, PartnerBuyResultDto, PartnerCorridorDto, PartnerCountryDto, PartnerCustomerDto, PartnerCustomerKycSnapshotDto, PartnerCustomerSnapshotDto, PartnerCustomerWalletSnapshotDto, PartnerDepositAddressDto, PartnerFeatureDto, PartnerFundingChargeDto, PartnerGlobalSendQuoteDto, PartnerGlobalSendResultDto, PartnerKycRecordDto, PartnerKycSubmissionDto, PartnerLedgerEntryDto, PartnerNetworkDto, PartnerRampQuoteDto, PartnerRateDto, PartnerReceivingAccountDto, PartnerReceivingActivityDto, PartnerReverificationRequestDto, PartnerSelfieCheckDto, PartnerSellResultDto, PartnerSendNetworkDto, PartnerSendQuoteDto, PartnerSendResultDto, PartnerTierStateDto, PartnerTierStatus, PartnerUploadedDocumentDto, PartnerVerificationInput, PartnerVerificationRecordDto, PartnerVerificationSummaryDto, PartnerVerificationTiersDto, PartnerVirtualAccountDto, PartnerWebhookConfigDto, PartnerWebhookDeliveryDetailDto, PartnerWebhookDeliveryDto, PartnerWebhookSecretDto, PartnerWebhookTestDto, PartnerWithdrawalBankAccountDto, PartnerWithdrawalDto, PartnerWithdrawalQuoteDto, ProfileChangePasswordData, ProfileChangePasswordResponse, ProfileChangePasswordResponses, ProfileDeleteAccountData, ProfileDeleteAccountResponse, ProfileDeleteAccountResponses, ProfileProfileData, ProfileProfileResponse, ProfileProfileResponses, ProfileUpdateProfileData, ProfileUpdateProfileResponse, ProfileUpdateProfileResponses, ProfileWithdrawalsData, ProfileWithdrawalsResponse, ProfileWithdrawalsResponses, QuoteSendDto, RampBuyData, RampBuyQuoteData, RampBuyQuoteResponse, RampBuyQuoteResponses, RampBuyResponse, RampBuyResponses, RampRateData, RampRateResponse, RampRateResponses, RampSellData, RampSellNetworksData, RampSellNetworksResponse, RampSellNetworksResponses, RampSellQuoteData, RampSellQuoteResponse, RampSellQuoteResponses, RampSellResponse, RampSellResponses, ReceivingActivityData, ReceivingActivityResponse, ReceivingActivityResponses, ReceivingCurrenciesData, ReceivingCurrenciesResponse, ReceivingCurrenciesResponses, ReceivingListData, ReceivingListResponse, ReceivingListResponses, ReceivingOpenData, ReceivingOpenResponse, ReceivingOpenResponses, ReceivingRefreshData, ReceivingRefreshResponse, ReceivingRefreshResponses, RegisterCustomerDto, ResetPassword, ReverificationItem, ReverificationStatus, SendDto, SendNetworksData, SendNetworksResponse, SendNetworksResponses, SendQuoteData, SendQuoteResponse, SendQuoteResponses, SendSubmitData, SendSubmitResponse, SendSubmitResponses, SetWebhookUrlDto, SubmitTier3Dto, Tier1KycDto, Tier2KycDto, UpdateCustomerProfileDto, VerifyAccountNumberInput, WalletAddressesData, WalletAddressesResponse, WalletAddressesResponses, WalletBalanceData, WalletBalanceResponse, WalletBalanceResponses, WalletFundingChargesData, WalletFundingChargesResponse, WalletFundingChargesResponses, WalletInitiateFundingChargeData, WalletInitiateFundingChargeResponse, WalletInitiateFundingChargeResponses, WalletStreamBalanceData, WalletStreamBalanceResponses, WalletTransactionsData, WalletTransactionsResponse, WalletTransactionsResponses, WalletVirtualAccountForData, WalletVirtualAccountForResponse, WalletVirtualAccountForResponses, WalletWithdrawalQuoteData, WalletWithdrawalQuoteResponse, WalletWithdrawalQuoteResponses, WalletWithdrawData, WalletWithdrawResponse, WalletWithdrawResponses, WebhookConfigData, WebhookConfigResponse, WebhookConfigResponses, WebhookDeliveriesData, WebhookDeliveriesResponse, WebhookDeliveriesResponses, WebhookDeliveryData, WebhookDeliveryResponse, WebhookDeliveryResponses, WebhookDeliveryStatus, WebhookReplayData, WebhookReplayResponse, WebhookReplayResponses, WebhookRotateSecretData, WebhookRotateSecretResponse, WebhookRotateSecretResponses, WebhookSetUrlData, WebhookSetUrlResponse, WebhookSetUrlResponses, WithdrawalStatus, WithdrawDto } from './types.gen';

package/dist/sdk.gen.d.ts

@@ -1,5 +1,5 @@
 import { type Client, type ClientMeta, type Options as Options2, type RequestResult, type TDataShape } from './client';
-import type { BankAddAccountData, BankAddAccountResponses, BankBanksData, BankBanksResponses, BankDeleteAccountData, BankDeleteAccountResponses, BankGetAccountsData, BankGetAccountsResponses, BankSetDefaultAccountData, BankSetDefaultAccountResponses, BankVerifyAccountData, BankVerifyAccountResponses, CountriesListData, CountriesListResponses, CustomersFullData, CustomersFullResponses, CustomersGetData, CustomersGetResponses, CustomersRegisterData, CustomersRegisterResponses, FeaturesListData, FeaturesListResponses, GlobalSendCorridorsData, GlobalSendCorridorsResponses, GlobalSendInitiateData, GlobalSendInitiateResponses, GlobalSendQuoteData, GlobalSendQuoteResponses, GlobalSendVerificationStatusData, GlobalSendVerificationStatusResponses, KycDocumentData, KycDocumentResponses, KycReverificationData, KycReverificationResponses, KycSelfieCheckRouteData, KycSelfieCheckRouteResponses, KycStatusData, KycStatusResponses, KycTier1Data, KycTier1Responses, KycTier2Data, KycTier2Responses, KycTier3Data, KycTier3Responses, ProfileChangePasswordData, ProfileChangePasswordResponses, ProfileDeleteAccountData, ProfileDeleteAccountResponses, ProfileGetSettlementModeData, ProfileGetSettlementModeResponses, ProfileProfileData, ProfileProfileResponses, ProfileSetSettlementModeData, ProfileSetSettlementModeResponses, ProfileUpdateProfileData, ProfileUpdateProfileResponses, ProfileWithdrawalsData, ProfileWithdrawalsResponses, RampBuyData, RampBuyQuoteData, RampBuyQuoteResponses, RampBuyResponses, RampRateData, RampRateResponses, RampSellData, RampSellNetworksData, RampSellNetworksResponses, RampSellQuoteData, RampSellQuoteResponses, RampSellResponses, ReceivingActivityData, ReceivingActivityResponses, ReceivingCurrenciesData, ReceivingCurrenciesResponses, ReceivingListData, ReceivingListResponses, ReceivingOpenData, ReceivingOpenResponses, ReceivingRefreshData, ReceivingRefreshResponses, SendNetworksData, SendNetworksResponses, SendQuoteData, SendQuoteResponses, SendSubmitData, SendSubmitResponses, WalletAddressesData, WalletAddressesResponses, WalletBalanceData, WalletBalanceResponses, WalletFundingChargesData, WalletFundingChargesResponses, WalletInitiateFundingChargeData, WalletInitiateFundingChargeResponses, WalletStreamBalanceData, WalletStreamBalanceResponses, WalletTransactionsData, WalletTransactionsResponses, WalletVirtualAccountForData, WalletVirtualAccountForResponses, WalletWithdrawData, WalletWithdrawResponses, WebhookConfigData, WebhookConfigResponses, WebhookDeliveriesData, WebhookDeliveriesResponses, WebhookDeliveryData, WebhookDeliveryResponses, WebhookReplayData, WebhookReplayResponses, WebhookRotateSecretData, WebhookRotateSecretResponses, WebhookSetUrlData, WebhookSetUrlResponses } from './types.gen';
+import type { BankAddAccountData, BankAddAccountResponses, BankBanksData, BankBanksResponses, BankDeleteAccountData, BankDeleteAccountResponses, BankGetAccountsData, BankGetAccountsResponses, BankSetDefaultAccountData, BankSetDefaultAccountResponses, BankVerifyAccountData, BankVerifyAccountResponses, CountriesListData, CountriesListResponses, CustomersFullData, CustomersFullResponses, CustomersGetData, CustomersGetResponses, CustomersRegisterData, CustomersRegisterResponses, FeaturesListData, FeaturesListResponses, GlobalSendCorridorsData, GlobalSendCorridorsResponses, GlobalSendInitiateData, GlobalSendInitiateResponses, GlobalSendQuoteData, GlobalSendQuoteResponses, GlobalSendVerificationStatusData, GlobalSendVerificationStatusResponses, KycDocumentData, KycDocumentResponses, KycReverificationData, KycReverificationResponses, KycSelfieCheckRouteData, KycSelfieCheckRouteResponses, KycStatusData, KycStatusResponses, KycSummaryData, KycSummaryResponses, KycTier1Data, KycTier1Responses, KycTier2Data, KycTier2Responses, KycTier3Data, KycTier3Responses, ProfileChangePasswordData, ProfileChangePasswordResponses, ProfileDeleteAccountData, ProfileDeleteAccountResponses, ProfileProfileData, ProfileProfileResponses, ProfileUpdateProfileData, ProfileUpdateProfileResponses, ProfileWithdrawalsData, ProfileWithdrawalsResponses, RampBuyData, RampBuyQuoteData, RampBuyQuoteResponses, RampBuyResponses, RampRateData, RampRateResponses, RampSellData, RampSellNetworksData, RampSellNetworksResponses, RampSellQuoteData, RampSellQuoteResponses, RampSellResponses, ReceivingActivityData, ReceivingActivityResponses, ReceivingCurrenciesData, ReceivingCurrenciesResponses, ReceivingListData, ReceivingListResponses, ReceivingOpenData, ReceivingOpenResponses, ReceivingRefreshData, ReceivingRefreshResponses, SendNetworksData, SendNetworksResponses, SendQuoteData, SendQuoteResponses, SendSubmitData, SendSubmitResponses, WalletAddressesData, WalletAddressesResponses, WalletBalanceData, WalletBalanceResponses, WalletFundingChargesData, WalletFundingChargesResponses, WalletInitiateFundingChargeData, WalletInitiateFundingChargeResponses, WalletStreamBalanceData, WalletStreamBalanceResponses, WalletTransactionsData, WalletTransactionsResponses, WalletVirtualAccountForData, WalletVirtualAccountForResponses, WalletWithdrawalQuoteData, WalletWithdrawalQuoteResponses, WalletWithdrawData, WalletWithdrawResponses, WebhookConfigData, WebhookConfigResponses, WebhookDeliveriesData, WebhookDeliveriesResponses, WebhookDeliveryData, WebhookDeliveryResponses, WebhookReplayData, WebhookReplayResponses, WebhookRotateSecretData, WebhookRotateSecretResponses, WebhookSetUrlData, WebhookSetUrlResponses } from './types.gen';
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<TData, ThrowOnError, TResponse> & {
     /**
      * You can provide a client instance returned by `createClient()` instead of
@@ -64,20 +64,18 @@ export declare class Profile extends HeyApiClient {
      * Change the customer's password
      */
     changePassword<ThrowOnError extends boolean = false>(options: Options<ProfileChangePasswordData, ThrowOnError>): RequestResult<ProfileChangePasswordResponses, unknown, ThrowOnError>;
-    /**
-     * Read the customer's settlement preference (AUTO to default bank vs MANUAL hold)
-     */
-    getSettlementMode<ThrowOnError extends boolean = false>(options: Options<ProfileGetSettlementModeData, ThrowOnError>): RequestResult<ProfileGetSettlementModeResponses, unknown, ThrowOnError>;
-    /**
-     * Update how the customer's sale proceeds settle
-     */
-    setSettlementMode<ThrowOnError extends boolean = false>(options: Options<ProfileSetSettlementModeData, ThrowOnError>): RequestResult<ProfileSetSettlementModeResponses, unknown, ThrowOnError>;
     /**
      * The customer's withdrawal / global payout history, newest first
      */
     withdrawals<ThrowOnError extends boolean = false>(options: Options<ProfileWithdrawalsData, ThrowOnError>): RequestResult<ProfileWithdrawalsResponses, unknown, ThrowOnError>;
 }
 export declare class Kyc extends HeyApiClient {
+    /**
+     * Where the customer stands, and what to submit next
+     *
+     * The recommended single read: the highest approved tier, each tier's status, the inputs to submit next (with any open re-verification items first), the open re-verification request, and the KYC records. Replaces calling GET .../kyc and GET .../kyc/reverification separately.
+     */
+    summary<ThrowOnError extends boolean = false>(options: Options<KycSummaryData, ThrowOnError>): RequestResult<KycSummaryResponses, unknown, ThrowOnError>;
     /**
      * A customer's KYC records, newest first
      */
@@ -136,8 +134,16 @@ export declare class Wallet extends HeyApiClient {
      * Issued on first read in the customer's own fiat (NGN needs an approved BVN first); the same account is returned on every read after.
      */
     virtualAccountFor<ThrowOnError extends boolean = false>(options: Options<WalletVirtualAccountForData, ThrowOnError>): RequestResult<WalletVirtualAccountForResponses, unknown, ThrowOnError>;
+    /**
+     * Price a withdrawal before submitting it
+     *
+     * The withdrawal fee (a percentage of the amount plus a fixed charge for the currency) is charged on top of the amount: the bank receives `amount`, the balance is debited `totalDebited`. Nothing is reserved.
+     */
+    withdrawalQuote<ThrowOnError extends boolean = false>(options: Options<WalletWithdrawalQuoteData, ThrowOnError>): RequestResult<WalletWithdrawalQuoteResponses, unknown, ThrowOnError>;
     /**
      * Pay a held balance out to the customer's default bank account
+     *
+     * The bank receives `amount`; the withdrawal fee is debited on top of it. Price it first with GET .../withdraw/quote.
      */
     withdraw<ThrowOnError extends boolean = false>(options: Options<WalletWithdrawData, ThrowOnError>): RequestResult<WalletWithdrawResponses, unknown, ThrowOnError>;
     /**
@@ -191,13 +197,13 @@ export declare class Ramp extends HeyApiClient {
      */
     buy<ThrowOnError extends boolean = false>(options: Options<RampBuyData, ThrowOnError>): RequestResult<RampBuyResponses, unknown, ThrowOnError>;
     /**
-     * Networks the customer can sell USDT on
+     * Networks the customer can deposit USDT on
      */
     sellNetworks<ThrowOnError extends boolean = false>(options: Options<RampSellNetworksData, ThrowOnError>): RequestResult<RampSellNetworksResponses, unknown, ThrowOnError>;
     /**
-     * Live USDT rates in the customer's local fiat, for previewing a conversion
+     * Live all-in USDT rates in the customer's local fiat, for previewing a conversion
      *
-     * Does not lock a rate -- checkout still goes through the quote routes.
+     * Rates include our spread and every fee, so amount * rate is what the customer pays or receives. Pass ?amount (USDT) to fold the fixed exchange fee into sellRate for that amount. Does not lock a rate -- checkout still goes through the quote routes.
      */
     rate<ThrowOnError extends boolean = false>(options: Options<RampRateData, ThrowOnError>): RequestResult<RampRateResponses, unknown, ThrowOnError>;
     /**

package/dist/sdk.gen.js

@@ -120,42 +120,30 @@ class Profile extends HeyApiClient {
         });
     }
     /**
-     * Read the customer's settlement preference (AUTO to default bank vs MANUAL hold)
+     * The customer's withdrawal / global payout history, newest first
      */
-    getSettlementMode(options) {
+    withdrawals(options) {
         return (options.client ?? this.client).get({
             security: [{ name: 'x-api-key', type: 'apiKey' }],
-            url: '/api/v1/partner/v1/customers/{customerId}/settlement-mode',
+            url: '/api/v1/partner/v1/customers/{customerId}/withdrawals',
             ...options
         });
     }
+}
+exports.Profile = Profile;
+class Kyc extends HeyApiClient {
     /**
-     * Update how the customer's sale proceeds settle
-     */
-    setSettlementMode(options) {
-        return (options.client ?? this.client).patch({
-            security: [{ name: 'x-api-key', type: 'apiKey' }],
-            url: '/api/v1/partner/v1/customers/{customerId}/settlement-mode',
-            ...options,
-            headers: {
-                'Content-Type': 'application/json',
-                ...options.headers
-            }
-        });
-    }
-    /**
-     * The customer's withdrawal / global payout history, newest first
+     * Where the customer stands, and what to submit next
+     *
+     * The recommended single read: the highest approved tier, each tier's status, the inputs to submit next (with any open re-verification items first), the open re-verification request, and the KYC records. Replaces calling GET .../kyc and GET .../kyc/reverification separately.
      */
-    withdrawals(options) {
+    summary(options) {
         return (options.client ?? this.client).get({
             security: [{ name: 'x-api-key', type: 'apiKey' }],
-            url: '/api/v1/partner/v1/customers/{customerId}/withdrawals',
+            url: '/api/v1/partner/v1/customers/{customerId}/verification',
             ...options
         });
     }
-}
-exports.Profile = Profile;
-class Kyc extends HeyApiClient {
     /**
      * A customer's KYC records, newest first
      */
@@ -308,8 +296,22 @@ class Wallet extends HeyApiClient {
             ...options
         });
     }
+    /**
+     * Price a withdrawal before submitting it
+     *
+     * The withdrawal fee (a percentage of the amount plus a fixed charge for the currency) is charged on top of the amount: the bank receives `amount`, the balance is debited `totalDebited`. Nothing is reserved.
+     */
+    withdrawalQuote(options) {
+        return (options.client ?? this.client).get({
+            security: [{ name: 'x-api-key', type: 'apiKey' }],
+            url: '/api/v1/partner/v1/customers/{customerId}/withdraw/quote',
+            ...options
+        });
+    }
     /**
      * Pay a held balance out to the customer's default bank account
+     *
+     * The bank receives `amount`; the withdrawal fee is debited on top of it. Price it first with GET .../withdraw/quote.
      */
     withdraw(options) {
         return (options.client ?? this.client).post({
@@ -470,7 +472,7 @@ class Ramp extends HeyApiClient {
         });
     }
     /**
-     * Networks the customer can sell USDT on
+     * Networks the customer can deposit USDT on
      */
     sellNetworks(options) {
         return (options.client ?? this.client).get({
@@ -480,9 +482,9 @@ class Ramp extends HeyApiClient {
         });
     }
     /**
-     * Live USDT rates in the customer's local fiat, for previewing a conversion
+     * Live all-in USDT rates in the customer's local fiat, for previewing a conversion
      *
-     * Does not lock a rate -- checkout still goes through the quote routes.
+     * Rates include our spread and every fee, so amount * rate is what the customer pays or receives. Pass ?amount (USDT) to fold the fixed exchange fee into sellRate for that amount. Does not lock a rate -- checkout still goes through the quote routes.
      */
     rate(options) {
         return (options.client ?? this.client).get({

package/dist/types.gen.d.ts

@@ -1,7 +1,6 @@
 export type ClientOptions = {
     baseUrl: 'https://app.dutchmannetwork.online' | (string & {});
 };
-export type SettlementMode = 'AUTO' | 'MANUAL';
 export type PartnerCustomerDto = {
     id: string;
     firstName: string;
@@ -20,7 +19,6 @@ export type PartnerCustomerDto = {
      * When identity verification was approved; null until then.
      */
     verifiedAt: string | null;
-    settlementMode: SettlementMode;
     createdAt: string;
     updatedAt: string;
 };
@@ -107,6 +105,61 @@ export type PartnerCustomerSnapshotDto = {
     kyc: PartnerCustomerKycSnapshotDto;
     wallet: PartnerCustomerWalletSnapshotDto;
 };
+/**
+ * NOT_STARTED when nothing has been submitted for the tier; otherwise the decision on the newest submission.
+ */
+export type PartnerTierStatus = 'NOT_STARTED' | 'PENDING' | 'REVIEW' | 'APPROVED' | 'REJECTED';
+export type PartnerTierStateDto = {
+    /**
+     * NOT_STARTED when nothing has been submitted for the tier; otherwise the decision on the newest submission.
+     */
+    status: PartnerTierStatus;
+    /**
+     * When the tier last changed; null when NOT_STARTED.
+     */
+    updatedAt: string | null;
+    /**
+     * Why it was REJECTED; null otherwise.
+     */
+    rejectionReason: string | null;
+};
+export type PartnerVerificationTiersDto = {
+    /**
+     * Tier 1: BVN + NIN.
+     */
+    1: PartnerTierStateDto;
+    /**
+     * Tier 2: ID document + selfie.
+     */
+    2: PartnerTierStateDto;
+    /**
+     * Tier 3: date of birth + address, decided by the cross-border verification partners.
+     */
+    3: PartnerTierStateDto;
+};
+/**
+ * What to submit next, in order. BVN and NIN go to POST .../kyc/tier1; ID_DOCUMENT and SELFIE to POST .../kyc/tier2; DATE_OF_BIRTH and ADDRESS to POST .../kyc/tier3; COUNTRY and ADDRESS_PROOF only ever appear from an open re-verification request. Empty when the next tier is already PENDING or in REVIEW, or every tier is APPROVED.
+ */
+export type PartnerVerificationInput = 'BVN' | 'NIN' | 'ID_DOCUMENT' | 'SELFIE' | 'DATE_OF_BIRTH' | 'ADDRESS' | 'COUNTRY' | 'ADDRESS_PROOF';
+export type PartnerVerificationSummaryDto = {
+    /**
+     * The highest APPROVED tier; 0 when none is.
+     */
+    currentTier: 0 | 1 | 2 | 3;
+    tiers: PartnerVerificationTiersDto;
+    /**
+     * What to submit next, in order. BVN and NIN go to POST .../kyc/tier1; ID_DOCUMENT and SELFIE to POST .../kyc/tier2; DATE_OF_BIRTH and ADDRESS to POST .../kyc/tier3; COUNTRY and ADDRESS_PROOF only ever appear from an open re-verification request. Empty when the next tier is already PENDING or in REVIEW, or every tier is APPROVED.
+     */
+    nextRequired: Array<PartnerVerificationInput>;
+    /**
+     * The open re-verification request an admin has raised, or null. Its items are already at the front of nextRequired.
+     */
+    reverification: PartnerReverificationRequestDto | null;
+    /**
+     * Every KYC record, newest first -- the same as GET .../kyc.
+     */
+    records: Array<PartnerKycRecordDto>;
+};
 export type PartnerKycSubmissionDto = {
     /**
      * APPROVED when the checks cleared immediately; REVIEW while a reviewer decides.
@@ -217,7 +270,7 @@ export type PartnerLedgerEntryDto = {
     id: string;
     type: LedgerEntryType;
     /**
-     * deposit | fiat.deposit | withdrawal | withdrawal.reversal | buy | sell | crypto_send | crypto_send.reversal | offramp.settlement | reversal
+     * deposit | fiat.deposit | withdrawal | withdrawal.fee | withdrawal.reversal | buy | sell | crypto_send | crypto_send.reversal | offramp.settlement | reversal
      */
     reason: string;
     currency: string;
@@ -237,6 +290,29 @@ export type PartnerLedgerEntryDto = {
     network: string | null;
     createdAt: string;
 };
+export type PartnerWithdrawalQuoteDto = {
+    currency: string;
+    /**
+     * What the bank account receives.
+     */
+    amount: number;
+    /**
+     * Withdrawal fee, same currency: the percentage fee on the amount plus the fixed fee for the currency.
+     */
+    fee: number;
+    /**
+     * amount + fee: what leaves the balance.
+     */
+    totalDebited: number;
+    /**
+     * Percentage part of the fee, basis points.
+     */
+    feeBps: number;
+    /**
+     * Fixed part of the fee, same currency.
+     */
+    feeFlat: number;
+};
 export type WithdrawalStatus = 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'PENDING_LIQUIDITY';
 export type PartnerWithdrawalBankAccountDto = {
     bankName: string | null;
@@ -247,9 +323,17 @@ export type PartnerWithdrawalDto = {
     id: string;
     reference: string;
     /**
-     * Decimal string, e.g. "5000.00000000".
+     * What the bank account receives. Decimal string, e.g. "5000.00000000".
      */
     amount: string;
+    /**
+     * Withdrawal fee charged on top of amount. Decimal string.
+     */
+    fee: string;
+    /**
+     * amount + fee: what left the balance. Decimal string.
+     */
+    totalDebited: string;
     currency: string;
     status: WithdrawalStatus;
     failureReason: string | null;
@@ -259,9 +343,13 @@ export type PartnerWithdrawalDto = {
 };
 export type WithdrawDto = {
     /**
-     * Amount to withdraw
+     * Amount the bank account receives. The withdrawal fee is charged on top, so the balance is debited amount + fee.
      */
     amount: number;
+    /**
+     * Idempotency key. Resending the same value returns the existing withdrawal rather than moving money again — pass the client's request id. Letters, digits, dot, underscore and hyphen; 120 characters max.
+     */
+    reference?: string;
 };
 export type FundingChargeStatus = 'PENDING' | 'SUCCESS' | 'FAILED';
 export type PartnerFundingChargeDto = {
@@ -294,6 +382,10 @@ export type InitiateFundingChargeDto = {
      * Amount to fund, in the user’s local fiat (derived from their country).
      */
     amount: number;
+    /**
+     * Idempotency key. Resending the same value returns the existing funding charge rather than moving money again — pass the client's request id. Letters, digits, dot, underscore and hyphen; 120 characters max.
+     */
+    reference?: string;
 };
 /**
  * The id to send in requests.
@@ -389,6 +481,10 @@ export type SendDto = {
      * Destination on-chain address
      */
     toAddress: string;
+    /**
+     * Idempotency key. Resending the same value returns the existing send rather than moving money again — pass the client's request id. Letters, digits, dot, underscore and hyphen; 120 characters max.
+     */
+    reference?: string;
 };
 export type PartnerCorridorDto = {
     /**
@@ -509,7 +605,7 @@ export type InitiateGlobalSendDto = {
     asset?: 'USDT' | 'USDC';
     beneficiary: GlobalSendBeneficiaryDto;
     /**
-     * Idempotency key. Resending the same value returns the existing send rather than debiting again — pass the client's request id.
+     * Idempotency key. Resending the same value returns the existing send rather than moving money again — pass the client's request id. Letters, digits, dot, underscore and hyphen; 120 characters max.
      */
     reference?: string;
 };
@@ -530,18 +626,9 @@ export type PartnerRampQuoteDto = {
      */
     rate: number;
     /**
-     * In the destination currency; 0 on a buy.
-     */
-    payoutFee: number;
-    /**
-     * In the destination currency; 0 on a buy.
-     */
-    networkGasFee: number;
-    /**
-     * In the destination currency; 0 on a buy.
+     * The exchange's fixed execution fee, in the destination currency; 0 on a buy.
      */
     exchangeFee: number;
-    network: BlockchainNetwork;
     /**
      * Seconds until the quote expires.
      */
@@ -552,7 +639,12 @@ export type GetQuoteDto = {
     sourceCurrency: string;
     destinationCurrency: string;
     type: 'sell' | 'buy';
-    network: 'ethereum' | 'polygon' | 'arbitrum' | 'base' | 'arc' | 'bsc' | 'optimism' | 'tron';
+    /**
+     * Ignored. A buy or sell moves balances only, so no chain is involved and no gas is charged; gas applies to crypto sends. Still accepted so older requests keep working.
+     *
+     * @deprecated
+     */
+    network?: 'ethereum' | 'polygon' | 'arbitrum' | 'base' | 'arc' | 'bsc' | 'optimism' | 'tron';
     /**
      * Optional preferred exchange venue. If omitted, the system auto-routes to the best available rate.
      */
@@ -584,23 +676,19 @@ export type PartnerNetworkDto = {
 export type PartnerRateDto = {
     fiatCurrency: string;
     /**
-     * Fiat per USDT when buying, spread applied.
+     * Fiat paid per USDT when buying. All-in: spread applied, and buys carry no fees.
      */
     buyRate: number;
     /**
-     * Fiat per USDT when selling, spread applied.
+     * Fiat received per USDT when selling. All-in: spread applied, plus the fixed exchange fee when ?amount was given, so amount * sellRate is exactly what the customer receives. The withdrawal fee is separate; see GET .../withdraw/quote.
      */
     sellRate: number;
     /**
-     * Sell-side payout fee, basis points of gross.
+     * USDT amount sellRate was priced for; null when ?amount was omitted, in which case the fixed exchange fee is not in sellRate.
      */
-    payoutFeeBps: number;
-    /**
-     * Sell-side gas estimate for the network, USD.
-     */
-    networkGasFeeUsd: number;
+    amount: number | null;
     /**
-     * Sell-side exchange fee, USDT.
+     * Fixed sell-side exchange fee, USDT. In sellRate only when ?amount was given.
      */
     exchangeFeeUsdt: number;
 };
@@ -608,12 +696,10 @@ export type PartnerSellResultDto = {
     reference: string;
     usdtSold: number;
     fiatCurrency: string;
-    fiatCredited: number;
-    settlementMode: SettlementMode;
     /**
-     * True when AUTO settlement already paid the proceeds to the default bank.
+     * Now on the customer's fiat balance; withdraw it with POST .../withdraw.
      */
-    autoWithdrawn: boolean;
+    fiatCredited: number;
 };
 export type PartnerBankDto = {
     code: string;
@@ -693,18 +779,6 @@ export type ResetPassword = {
     oldPassword: string;
     newPassword: string;
 };
-export type PartnerSettlementModeDto = {
-    /**
-     * AUTO pays sale proceeds straight to the default bank; MANUAL holds them as a fiat balance.
-     */
-    mode: SettlementMode;
-};
-export type SettlementModeDto = {
-    /**
-     * AUTO settles sale proceeds straight to the default bank; MANUAL holds them as an NGN balance to withdraw later.
-     */
-    mode: 'AUTO' | 'MANUAL';
-};
 export type PartnerReceivingAccountDto = {
     id: string;
     currency: string;
@@ -921,6 +995,24 @@ export type CustomersFullResponses = {
     };
 };
 export type CustomersFullResponse = CustomersFullResponses[keyof CustomersFullResponses];
+export type KycSummaryData = {
+    body?: never;
+    path: {
+        /**
+         * Id of one of your customers, as returned by customers.register.
+         */
+        customerId: string;
+    };
+    query?: never;
+    url: '/api/v1/partner/v1/customers/{customerId}/verification';
+};
+export type KycSummaryResponses = {
+    200: {
+        success: boolean;
+        data: PartnerVerificationSummaryDto;
+    };
+};
+export type KycSummaryResponse = KycSummaryResponses[keyof KycSummaryResponses];
 export type KycStatusData = {
     body?: never;
     path: {
@@ -1153,6 +1245,29 @@ export type WalletVirtualAccountForResponses = {
     };
 };
 export type WalletVirtualAccountForResponse = WalletVirtualAccountForResponses[keyof WalletVirtualAccountForResponses];
+export type WalletWithdrawalQuoteData = {
+    body?: never;
+    path: {
+        /**
+         * Id of one of your customers, as returned by customers.register.
+         */
+        customerId: string;
+    };
+    query: {
+        /**
+         * Amount the bank account would receive.
+         */
+        amount: number;
+    };
+    url: '/api/v1/partner/v1/customers/{customerId}/withdraw/quote';
+};
+export type WalletWithdrawalQuoteResponses = {
+    200: {
+        success: boolean;
+        data: PartnerWithdrawalQuoteDto;
+    };
+};
+export type WalletWithdrawalQuoteResponse = WalletWithdrawalQuoteResponses[keyof WalletWithdrawalQuoteResponses];
 export type WalletWithdrawData = {
     body: WithdrawDto;
     path: {
@@ -1412,9 +1527,15 @@ export type RampRateData = {
     };
     query?: {
         /**
-         * Chain the gas-fee estimate is quoted for. Only affects sell-side fees; buys are fee-free.
+         * Ignored. A buy or sell moves balances only, so no gas is priced into the rate; gas applies to crypto sends. Still accepted so older requests keep working.
+         *
+         * @deprecated
          */
         network?: 'ethereum' | 'polygon' | 'arbitrum' | 'base' | 'arc' | 'bsc' | 'optimism' | 'tron';
+        /**
+         * USDT amount to price the sell rate for. When given, the fixed exchange fee is spread over it, so amount * sellRate is exactly what the customer receives. Omit for a per-unit rate that carries the spread only.
+         */
+        amount?: number;
     };
     url: '/api/v1/partner/v1/customers/{customerId}/rate';
 };
@@ -1630,42 +1751,6 @@ export type ProfileChangePasswordResponses = {
     204: void;
 };
 export type ProfileChangePasswordResponse = ProfileChangePasswordResponses[keyof ProfileChangePasswordResponses];
-export type ProfileGetSettlementModeData = {
-    body?: never;
-    path: {
-        /**
-         * Id of one of your customers, as returned by customers.register.
-         */
-        customerId: string;
-    };
-    query?: never;
-    url: '/api/v1/partner/v1/customers/{customerId}/settlement-mode';
-};
-export type ProfileGetSettlementModeResponses = {
-    200: {
-        success: boolean;
-        data: PartnerSettlementModeDto;
-    };
-};
-export type ProfileGetSettlementModeResponse = ProfileGetSettlementModeResponses[keyof ProfileGetSettlementModeResponses];
-export type ProfileSetSettlementModeData = {
-    body: SettlementModeDto;
-    path: {
-        /**
-         * Id of one of your customers, as returned by customers.register.
-         */
-        customerId: string;
-    };
-    query?: never;
-    url: '/api/v1/partner/v1/customers/{customerId}/settlement-mode';
-};
-export type ProfileSetSettlementModeResponses = {
-    200: {
-        success: boolean;
-        data: PartnerSettlementModeDto;
-    };
-};
-export type ProfileSetSettlementModeResponse = ProfileSetSettlementModeResponses[keyof ProfileSetSettlementModeResponses];
 export type ProfileWithdrawalsData = {
     body?: never;
     path: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dutchman-bridge",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "TypeScript SDK for the Dutchman Bridge Partner API, generated from its OpenAPI specification.",
   "license": "UNLICENSED",
   "publishConfig": {

package/src/index.ts

@@ -2,4 +2,4 @@
 
 export { client, type CreateClientConfig } from './client.gen';
 export { Bank, Countries, Customers, DutchmanBridge, Features, GlobalSend, Kyc, type Options, Profile, Ramp, Receiving, Send, Wallet, Webhook } from './sdk.gen';
-export type { AddAccountDto, BankAddAccountData, BankAddAccountResponse, BankAddAccountResponses, BankBanksData, BankBanksResponse, BankBanksResponses, BankDeleteAccountData, BankDeleteAccountResponse, BankDeleteAccountResponses, BankGetAccountsData, BankGetAccountsResponse, BankGetAccountsResponses, BankSetDefaultAccountData, BankSetDefaultAccountResponse, BankSetDefaultAccountResponses, BankVerifyAccountData, BankVerifyAccountResponse, BankVerifyAccountResponses, BlockchainNetwork, CheckSelfieDto, ClientOptions, CountriesListData, CountriesListResponse, CountriesListResponses, CustomerSellDto, CustomersFullData, CustomersFullResponse, CustomersFullResponses, CustomersGetData, CustomersGetResponse, CustomersGetResponses, CustomersRegisterData, CustomersRegisterResponse, CustomersRegisterResponses, FeaturesListData, FeaturesListResponse, FeaturesListResponses, FeatureStatus, FundingChargeStatus, GetQuoteDto, GlobalSendBeneficiaryDto, GlobalSendCorridorsData, GlobalSendCorridorsResponse, GlobalSendCorridorsResponses, GlobalSendInitiateData, GlobalSendInitiateResponse, GlobalSendInitiateResponses, GlobalSendQuoteData, GlobalSendQuoteDto, GlobalSendQuoteResponse, GlobalSendQuoteResponses, GlobalSendVerificationStatusData, GlobalSendVerificationStatusResponse, GlobalSendVerificationStatusResponses, InitiateFundingChargeDto, InitiateGlobalSendDto, KycDocumentData, KycDocumentResponse, KycDocumentResponses, KycReverificationData, KycReverificationResponse, KycReverificationResponses, KycSelfieCheckRouteData, KycSelfieCheckRouteResponse, KycSelfieCheckRouteResponses, KycStatus, KycStatusData, KycStatusResponse, KycStatusResponses, KycTier1Data, KycTier1Response, KycTier1Responses, KycTier2Data, KycTier2Response, KycTier2Responses, KycTier3Data, KycTier3Response, KycTier3Responses, LedgerEntryType, PartnerAccountVerificationDto, PartnerBalanceDto, PartnerBankAccountDto, PartnerBankDto, PartnerBuyResultDto, PartnerCorridorDto, PartnerCountryDto, PartnerCustomerDto, PartnerCustomerKycSnapshotDto, PartnerCustomerSnapshotDto, PartnerCustomerWalletSnapshotDto, PartnerDepositAddressDto, PartnerFeatureDto, PartnerFundingChargeDto, PartnerGlobalSendQuoteDto, PartnerGlobalSendResultDto, PartnerKycRecordDto, PartnerKycSubmissionDto, PartnerLedgerEntryDto, PartnerNetworkDto, PartnerRampQuoteDto, PartnerRateDto, PartnerReceivingAccountDto, PartnerReceivingActivityDto, PartnerReverificationRequestDto, PartnerSelfieCheckDto, PartnerSellResultDto, PartnerSendNetworkDto, PartnerSendQuoteDto, PartnerSendResultDto, PartnerSettlementModeDto, PartnerUploadedDocumentDto, PartnerVerificationRecordDto, PartnerVirtualAccountDto, PartnerWebhookConfigDto, PartnerWebhookDeliveryDetailDto, PartnerWebhookDeliveryDto, PartnerWebhookSecretDto, PartnerWebhookTestDto, PartnerWithdrawalBankAccountDto, PartnerWithdrawalDto, ProfileChangePasswordData, ProfileChangePasswordResponse, ProfileChangePasswordResponses, ProfileDeleteAccountData, ProfileDeleteAccountResponse, ProfileDeleteAccountResponses, ProfileGetSettlementModeData, ProfileGetSettlementModeResponse, ProfileGetSettlementModeResponses, ProfileProfileData, ProfileProfileResponse, ProfileProfileResponses, ProfileSetSettlementModeData, ProfileSetSettlementModeResponse, ProfileSetSettlementModeResponses, ProfileUpdateProfileData, ProfileUpdateProfileResponse, ProfileUpdateProfileResponses, ProfileWithdrawalsData, ProfileWithdrawalsResponse, ProfileWithdrawalsResponses, QuoteSendDto, RampBuyData, RampBuyQuoteData, RampBuyQuoteResponse, RampBuyQuoteResponses, RampBuyResponse, RampBuyResponses, RampRateData, RampRateResponse, RampRateResponses, RampSellData, RampSellNetworksData, RampSellNetworksResponse, RampSellNetworksResponses, RampSellQuoteData, RampSellQuoteResponse, RampSellQuoteResponses, RampSellResponse, RampSellResponses, ReceivingActivityData, ReceivingActivityResponse, ReceivingActivityResponses, ReceivingCurrenciesData, ReceivingCurrenciesResponse, ReceivingCurrenciesResponses, ReceivingListData, ReceivingListResponse, ReceivingListResponses, ReceivingOpenData, ReceivingOpenResponse, ReceivingOpenResponses, ReceivingRefreshData, ReceivingRefreshResponse, ReceivingRefreshResponses, RegisterCustomerDto, ResetPassword, ReverificationItem, ReverificationStatus, SendDto, SendNetworksData, SendNetworksResponse, SendNetworksResponses, SendQuoteData, SendQuoteResponse, SendQuoteResponses, SendSubmitData, SendSubmitResponse, SendSubmitResponses, SettlementMode, SettlementModeDto, SetWebhookUrlDto, SubmitTier3Dto, Tier1KycDto, Tier2KycDto, UpdateCustomerProfileDto, VerifyAccountNumberInput, WalletAddressesData, WalletAddressesResponse, WalletAddressesResponses, WalletBalanceData, WalletBalanceResponse, WalletBalanceResponses, WalletFundingChargesData, WalletFundingChargesResponse, WalletFundingChargesResponses, WalletInitiateFundingChargeData, WalletInitiateFundingChargeResponse, WalletInitiateFundingChargeResponses, WalletStreamBalanceData, WalletStreamBalanceResponses, WalletTransactionsData, WalletTransactionsResponse, WalletTransactionsResponses, WalletVirtualAccountForData, WalletVirtualAccountForResponse, WalletVirtualAccountForResponses, WalletWithdrawData, WalletWithdrawResponse, WalletWithdrawResponses, WebhookConfigData, WebhookConfigResponse, WebhookConfigResponses, WebhookDeliveriesData, WebhookDeliveriesResponse, WebhookDeliveriesResponses, WebhookDeliveryData, WebhookDeliveryResponse, WebhookDeliveryResponses, WebhookDeliveryStatus, WebhookReplayData, WebhookReplayResponse, WebhookReplayResponses, WebhookRotateSecretData, WebhookRotateSecretResponse, WebhookRotateSecretResponses, WebhookSetUrlData, WebhookSetUrlResponse, WebhookSetUrlResponses, WithdrawalStatus, WithdrawDto } from './types.gen';
+export type { AddAccountDto, BankAddAccountData, BankAddAccountResponse, BankAddAccountResponses, BankBanksData, BankBanksResponse, BankBanksResponses, BankDeleteAccountData, BankDeleteAccountResponse, BankDeleteAccountResponses, BankGetAccountsData, BankGetAccountsResponse, BankGetAccountsResponses, BankSetDefaultAccountData, BankSetDefaultAccountResponse, BankSetDefaultAccountResponses, BankVerifyAccountData, BankVerifyAccountResponse, BankVerifyAccountResponses, BlockchainNetwork, CheckSelfieDto, ClientOptions, CountriesListData, CountriesListResponse, CountriesListResponses, CustomerSellDto, CustomersFullData, CustomersFullResponse, CustomersFullResponses, CustomersGetData, CustomersGetResponse, CustomersGetResponses, CustomersRegisterData, CustomersRegisterResponse, CustomersRegisterResponses, FeaturesListData, FeaturesListResponse, FeaturesListResponses, FeatureStatus, FundingChargeStatus, GetQuoteDto, GlobalSendBeneficiaryDto, GlobalSendCorridorsData, GlobalSendCorridorsResponse, GlobalSendCorridorsResponses, GlobalSendInitiateData, GlobalSendInitiateResponse, GlobalSendInitiateResponses, GlobalSendQuoteData, GlobalSendQuoteDto, GlobalSendQuoteResponse, GlobalSendQuoteResponses, GlobalSendVerificationStatusData, GlobalSendVerificationStatusResponse, GlobalSendVerificationStatusResponses, InitiateFundingChargeDto, InitiateGlobalSendDto, KycDocumentData, KycDocumentResponse, KycDocumentResponses, KycReverificationData, KycReverificationResponse, KycReverificationResponses, KycSelfieCheckRouteData, KycSelfieCheckRouteResponse, KycSelfieCheckRouteResponses, KycStatus, KycStatusData, KycStatusResponse, KycStatusResponses, KycSummaryData, KycSummaryResponse, KycSummaryResponses, KycTier1Data, KycTier1Response, KycTier1Responses, KycTier2Data, KycTier2Response, KycTier2Responses, KycTier3Data, KycTier3Response, KycTier3Responses, LedgerEntryType, PartnerAccountVerificationDto, PartnerBalanceDto, PartnerBankAccountDto, PartnerBankDto, PartnerBuyResultDto, PartnerCorridorDto, PartnerCountryDto, PartnerCustomerDto, PartnerCustomerKycSnapshotDto, PartnerCustomerSnapshotDto, PartnerCustomerWalletSnapshotDto, PartnerDepositAddressDto, PartnerFeatureDto, PartnerFundingChargeDto, PartnerGlobalSendQuoteDto, PartnerGlobalSendResultDto, PartnerKycRecordDto, PartnerKycSubmissionDto, PartnerLedgerEntryDto, PartnerNetworkDto, PartnerRampQuoteDto, PartnerRateDto, PartnerReceivingAccountDto, PartnerReceivingActivityDto, PartnerReverificationRequestDto, PartnerSelfieCheckDto, PartnerSellResultDto, PartnerSendNetworkDto, PartnerSendQuoteDto, PartnerSendResultDto, PartnerTierStateDto, PartnerTierStatus, PartnerUploadedDocumentDto, PartnerVerificationInput, PartnerVerificationRecordDto, PartnerVerificationSummaryDto, PartnerVerificationTiersDto, PartnerVirtualAccountDto, PartnerWebhookConfigDto, PartnerWebhookDeliveryDetailDto, PartnerWebhookDeliveryDto, PartnerWebhookSecretDto, PartnerWebhookTestDto, PartnerWithdrawalBankAccountDto, PartnerWithdrawalDto, PartnerWithdrawalQuoteDto, ProfileChangePasswordData, ProfileChangePasswordResponse, ProfileChangePasswordResponses, ProfileDeleteAccountData, ProfileDeleteAccountResponse, ProfileDeleteAccountResponses, ProfileProfileData, ProfileProfileResponse, ProfileProfileResponses, ProfileUpdateProfileData, ProfileUpdateProfileResponse, ProfileUpdateProfileResponses, ProfileWithdrawalsData, ProfileWithdrawalsResponse, ProfileWithdrawalsResponses, QuoteSendDto, RampBuyData, RampBuyQuoteData, RampBuyQuoteResponse, RampBuyQuoteResponses, RampBuyResponse, RampBuyResponses, RampRateData, RampRateResponse, RampRateResponses, RampSellData, RampSellNetworksData, RampSellNetworksResponse, RampSellNetworksResponses, RampSellQuoteData, RampSellQuoteResponse, RampSellQuoteResponses, RampSellResponse, RampSellResponses, ReceivingActivityData, ReceivingActivityResponse, ReceivingActivityResponses, ReceivingCurrenciesData, ReceivingCurrenciesResponse, ReceivingCurrenciesResponses, ReceivingListData, ReceivingListResponse, ReceivingListResponses, ReceivingOpenData, ReceivingOpenResponse, ReceivingOpenResponses, ReceivingRefreshData, ReceivingRefreshResponse, ReceivingRefreshResponses, RegisterCustomerDto, ResetPassword, ReverificationItem, ReverificationStatus, SendDto, SendNetworksData, SendNetworksResponse, SendNetworksResponses, SendQuoteData, SendQuoteResponse, SendQuoteResponses, SendSubmitData, SendSubmitResponse, SendSubmitResponses, SetWebhookUrlDto, SubmitTier3Dto, Tier1KycDto, Tier2KycDto, UpdateCustomerProfileDto, VerifyAccountNumberInput, WalletAddressesData, WalletAddressesResponse, WalletAddressesResponses, WalletBalanceData, WalletBalanceResponse, WalletBalanceResponses, WalletFundingChargesData, WalletFundingChargesResponse, WalletFundingChargesResponses, WalletInitiateFundingChargeData, WalletInitiateFundingChargeResponse, WalletInitiateFundingChargeResponses, WalletStreamBalanceData, WalletStreamBalanceResponses, WalletTransactionsData, WalletTransactionsResponse, WalletTransactionsResponses, WalletVirtualAccountForData, WalletVirtualAccountForResponse, WalletVirtualAccountForResponses, WalletWithdrawalQuoteData, WalletWithdrawalQuoteResponse, WalletWithdrawalQuoteResponses, WalletWithdrawData, WalletWithdrawResponse, WalletWithdrawResponses, WebhookConfigData, WebhookConfigResponse, WebhookConfigResponses, WebhookDeliveriesData, WebhookDeliveriesResponse, WebhookDeliveriesResponses, WebhookDeliveryData, WebhookDeliveryResponse, WebhookDeliveryResponses, WebhookDeliveryStatus, WebhookReplayData, WebhookReplayResponse, WebhookReplayResponses, WebhookRotateSecretData, WebhookRotateSecretResponse, WebhookRotateSecretResponses, WebhookSetUrlData, WebhookSetUrlResponse, WebhookSetUrlResponses, WithdrawalStatus, WithdrawDto } from './types.gen';

package/src/sdk.gen.ts

@@ -2,7 +2,7 @@
 
 import { type Client, type ClientMeta, formDataBodySerializer, type Options as Options2, type RequestResult, type TDataShape } from './client';
 import { client } from './client.gen';
-import type { BankAddAccountData, BankAddAccountResponses, BankBanksData, BankBanksResponses, BankDeleteAccountData, BankDeleteAccountResponses, BankGetAccountsData, BankGetAccountsResponses, BankSetDefaultAccountData, BankSetDefaultAccountResponses, BankVerifyAccountData, BankVerifyAccountResponses, CountriesListData, CountriesListResponses, CustomersFullData, CustomersFullResponses, CustomersGetData, CustomersGetResponses, CustomersRegisterData, CustomersRegisterResponses, FeaturesListData, FeaturesListResponses, GlobalSendCorridorsData, GlobalSendCorridorsResponses, GlobalSendInitiateData, GlobalSendInitiateResponses, GlobalSendQuoteData, GlobalSendQuoteResponses, GlobalSendVerificationStatusData, GlobalSendVerificationStatusResponses, KycDocumentData, KycDocumentResponses, KycReverificationData, KycReverificationResponses, KycSelfieCheckRouteData, KycSelfieCheckRouteResponses, KycStatusData, KycStatusResponses, KycTier1Data, KycTier1Responses, KycTier2Data, KycTier2Responses, KycTier3Data, KycTier3Responses, ProfileChangePasswordData, ProfileChangePasswordResponses, ProfileDeleteAccountData, ProfileDeleteAccountResponses, ProfileGetSettlementModeData, ProfileGetSettlementModeResponses, ProfileProfileData, ProfileProfileResponses, ProfileSetSettlementModeData, ProfileSetSettlementModeResponses, ProfileUpdateProfileData, ProfileUpdateProfileResponses, ProfileWithdrawalsData, ProfileWithdrawalsResponses, RampBuyData, RampBuyQuoteData, RampBuyQuoteResponses, RampBuyResponses, RampRateData, RampRateResponses, RampSellData, RampSellNetworksData, RampSellNetworksResponses, RampSellQuoteData, RampSellQuoteResponses, RampSellResponses, ReceivingActivityData, ReceivingActivityResponses, ReceivingCurrenciesData, ReceivingCurrenciesResponses, ReceivingListData, ReceivingListResponses, ReceivingOpenData, ReceivingOpenResponses, ReceivingRefreshData, ReceivingRefreshResponses, SendNetworksData, SendNetworksResponses, SendQuoteData, SendQuoteResponses, SendSubmitData, SendSubmitResponses, WalletAddressesData, WalletAddressesResponses, WalletBalanceData, WalletBalanceResponses, WalletFundingChargesData, WalletFundingChargesResponses, WalletInitiateFundingChargeData, WalletInitiateFundingChargeResponses, WalletStreamBalanceData, WalletStreamBalanceResponses, WalletTransactionsData, WalletTransactionsResponses, WalletVirtualAccountForData, WalletVirtualAccountForResponses, WalletWithdrawData, WalletWithdrawResponses, WebhookConfigData, WebhookConfigResponses, WebhookDeliveriesData, WebhookDeliveriesResponses, WebhookDeliveryData, WebhookDeliveryResponses, WebhookReplayData, WebhookReplayResponses, WebhookRotateSecretData, WebhookRotateSecretResponses, WebhookSetUrlData, WebhookSetUrlResponses } from './types.gen';
+import type { BankAddAccountData, BankAddAccountResponses, BankBanksData, BankBanksResponses, BankDeleteAccountData, BankDeleteAccountResponses, BankGetAccountsData, BankGetAccountsResponses, BankSetDefaultAccountData, BankSetDefaultAccountResponses, BankVerifyAccountData, BankVerifyAccountResponses, CountriesListData, CountriesListResponses, CustomersFullData, CustomersFullResponses, CustomersGetData, CustomersGetResponses, CustomersRegisterData, CustomersRegisterResponses, FeaturesListData, FeaturesListResponses, GlobalSendCorridorsData, GlobalSendCorridorsResponses, GlobalSendInitiateData, GlobalSendInitiateResponses, GlobalSendQuoteData, GlobalSendQuoteResponses, GlobalSendVerificationStatusData, GlobalSendVerificationStatusResponses, KycDocumentData, KycDocumentResponses, KycReverificationData, KycReverificationResponses, KycSelfieCheckRouteData, KycSelfieCheckRouteResponses, KycStatusData, KycStatusResponses, KycSummaryData, KycSummaryResponses, KycTier1Data, KycTier1Responses, KycTier2Data, KycTier2Responses, KycTier3Data, KycTier3Responses, ProfileChangePasswordData, ProfileChangePasswordResponses, ProfileDeleteAccountData, ProfileDeleteAccountResponses, ProfileProfileData, ProfileProfileResponses, ProfileUpdateProfileData, ProfileUpdateProfileResponses, ProfileWithdrawalsData, ProfileWithdrawalsResponses, RampBuyData, RampBuyQuoteData, RampBuyQuoteResponses, RampBuyResponses, RampRateData, RampRateResponses, RampSellData, RampSellNetworksData, RampSellNetworksResponses, RampSellQuoteData, RampSellQuoteResponses, RampSellResponses, ReceivingActivityData, ReceivingActivityResponses, ReceivingCurrenciesData, ReceivingCurrenciesResponses, ReceivingListData, ReceivingListResponses, ReceivingOpenData, ReceivingOpenResponses, ReceivingRefreshData, ReceivingRefreshResponses, SendNetworksData, SendNetworksResponses, SendQuoteData, SendQuoteResponses, SendSubmitData, SendSubmitResponses, WalletAddressesData, WalletAddressesResponses, WalletBalanceData, WalletBalanceResponses, WalletFundingChargesData, WalletFundingChargesResponses, WalletInitiateFundingChargeData, WalletInitiateFundingChargeResponses, WalletStreamBalanceData, WalletStreamBalanceResponses, WalletTransactionsData, WalletTransactionsResponses, WalletVirtualAccountForData, WalletVirtualAccountForResponses, WalletWithdrawalQuoteData, WalletWithdrawalQuoteResponses, WalletWithdrawData, WalletWithdrawResponses, WebhookConfigData, WebhookConfigResponses, WebhookDeliveriesData, WebhookDeliveriesResponses, WebhookDeliveryData, WebhookDeliveryResponses, WebhookReplayData, WebhookReplayResponses, WebhookRotateSecretData, WebhookRotateSecretResponses, WebhookSetUrlData, WebhookSetUrlResponses } from './types.gen';
 
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<TData, ThrowOnError, TResponse> & {
     /**
@@ -146,32 +146,6 @@ export class Profile extends HeyApiClient {
         });
     }
     
-    /**
-     * Read the customer's settlement preference (AUTO to default bank vs MANUAL hold)
-     */
-    public getSettlementMode<ThrowOnError extends boolean = false>(options: Options<ProfileGetSettlementModeData, ThrowOnError>): RequestResult<ProfileGetSettlementModeResponses, unknown, ThrowOnError> {
-        return (options.client ?? this.client).get<ProfileGetSettlementModeResponses, unknown, ThrowOnError>({
-            security: [{ name: 'x-api-key', type: 'apiKey' }],
-            url: '/api/v1/partner/v1/customers/{customerId}/settlement-mode',
-            ...options
-        });
-    }
-    
-    /**
-     * Update how the customer's sale proceeds settle
-     */
-    public setSettlementMode<ThrowOnError extends boolean = false>(options: Options<ProfileSetSettlementModeData, ThrowOnError>): RequestResult<ProfileSetSettlementModeResponses, unknown, ThrowOnError> {
-        return (options.client ?? this.client).patch<ProfileSetSettlementModeResponses, unknown, ThrowOnError>({
-            security: [{ name: 'x-api-key', type: 'apiKey' }],
-            url: '/api/v1/partner/v1/customers/{customerId}/settlement-mode',
-            ...options,
-            headers: {
-                'Content-Type': 'application/json',
-                ...options.headers
-            }
-        });
-    }
-    
     /**
      * The customer's withdrawal / global payout history, newest first
      */
@@ -185,6 +159,19 @@ export class Profile extends HeyApiClient {
 }
 
 export class Kyc extends HeyApiClient {
+    /**
+     * Where the customer stands, and what to submit next
+     *
+     * The recommended single read: the highest approved tier, each tier's status, the inputs to submit next (with any open re-verification items first), the open re-verification request, and the KYC records. Replaces calling GET .../kyc and GET .../kyc/reverification separately.
+     */
+    public summary<ThrowOnError extends boolean = false>(options: Options<KycSummaryData, ThrowOnError>): RequestResult<KycSummaryResponses, unknown, ThrowOnError> {
+        return (options.client ?? this.client).get<KycSummaryResponses, unknown, ThrowOnError>({
+            security: [{ name: 'x-api-key', type: 'apiKey' }],
+            url: '/api/v1/partner/v1/customers/{customerId}/verification',
+            ...options
+        });
+    }
+    
     /**
      * A customer's KYC records, newest first
      */
@@ -348,8 +335,23 @@ export class Wallet extends HeyApiClient {
         });
     }
     
+    /**
+     * Price a withdrawal before submitting it
+     *
+     * The withdrawal fee (a percentage of the amount plus a fixed charge for the currency) is charged on top of the amount: the bank receives `amount`, the balance is debited `totalDebited`. Nothing is reserved.
+     */
+    public withdrawalQuote<ThrowOnError extends boolean = false>(options: Options<WalletWithdrawalQuoteData, ThrowOnError>): RequestResult<WalletWithdrawalQuoteResponses, unknown, ThrowOnError> {
+        return (options.client ?? this.client).get<WalletWithdrawalQuoteResponses, unknown, ThrowOnError>({
+            security: [{ name: 'x-api-key', type: 'apiKey' }],
+            url: '/api/v1/partner/v1/customers/{customerId}/withdraw/quote',
+            ...options
+        });
+    }
+    
     /**
      * Pay a held balance out to the customer's default bank account
+     *
+     * The bank receives `amount`; the withdrawal fee is debited on top of it. Price it first with GET .../withdraw/quote.
      */
     public withdraw<ThrowOnError extends boolean = false>(options: Options<WalletWithdrawData, ThrowOnError>): RequestResult<WalletWithdrawResponses, unknown, ThrowOnError> {
         return (options.client ?? this.client).post<WalletWithdrawResponses, unknown, ThrowOnError>({
@@ -519,7 +521,7 @@ export class Ramp extends HeyApiClient {
     }
     
     /**
-     * Networks the customer can sell USDT on
+     * Networks the customer can deposit USDT on
      */
     public sellNetworks<ThrowOnError extends boolean = false>(options: Options<RampSellNetworksData, ThrowOnError>): RequestResult<RampSellNetworksResponses, unknown, ThrowOnError> {
         return (options.client ?? this.client).get<RampSellNetworksResponses, unknown, ThrowOnError>({
@@ -530,9 +532,9 @@ export class Ramp extends HeyApiClient {
     }
     
     /**
-     * Live USDT rates in the customer's local fiat, for previewing a conversion
+     * Live all-in USDT rates in the customer's local fiat, for previewing a conversion
      *
-     * Does not lock a rate -- checkout still goes through the quote routes.
+     * Rates include our spread and every fee, so amount * rate is what the customer pays or receives. Pass ?amount (USDT) to fold the fixed exchange fee into sellRate for that amount. Does not lock a rate -- checkout still goes through the quote routes.
      */
     public rate<ThrowOnError extends boolean = false>(options: Options<RampRateData, ThrowOnError>): RequestResult<RampRateResponses, unknown, ThrowOnError> {
         return (options.client ?? this.client).get<RampRateResponses, unknown, ThrowOnError>({

package/src/types.gen.ts

@@ -4,8 +4,6 @@ export type ClientOptions = {
     baseUrl: 'https://app.dutchmannetwork.online' | (string & {});
 };
 
-export type SettlementMode = 'AUTO' | 'MANUAL';
-
 export type PartnerCustomerDto = {
     id: string;
     firstName: string;
@@ -24,7 +22,6 @@ export type PartnerCustomerDto = {
      * When identity verification was approved; null until then.
      */
     verifiedAt: string | null;
-    settlementMode: SettlementMode;
     createdAt: string;
     updatedAt: string;
 };
@@ -124,6 +121,66 @@ export type PartnerCustomerSnapshotDto = {
     wallet: PartnerCustomerWalletSnapshotDto;
 };
 
+/**
+ * NOT_STARTED when nothing has been submitted for the tier; otherwise the decision on the newest submission.
+ */
+export type PartnerTierStatus = 'NOT_STARTED' | 'PENDING' | 'REVIEW' | 'APPROVED' | 'REJECTED';
+
+export type PartnerTierStateDto = {
+    /**
+     * NOT_STARTED when nothing has been submitted for the tier; otherwise the decision on the newest submission.
+     */
+    status: PartnerTierStatus;
+    /**
+     * When the tier last changed; null when NOT_STARTED.
+     */
+    updatedAt: string | null;
+    /**
+     * Why it was REJECTED; null otherwise.
+     */
+    rejectionReason: string | null;
+};
+
+export type PartnerVerificationTiersDto = {
+    /**
+     * Tier 1: BVN + NIN.
+     */
+    1: PartnerTierStateDto;
+    /**
+     * Tier 2: ID document + selfie.
+     */
+    2: PartnerTierStateDto;
+    /**
+     * Tier 3: date of birth + address, decided by the cross-border verification partners.
+     */
+    3: PartnerTierStateDto;
+};
+
+/**
+ * What to submit next, in order. BVN and NIN go to POST .../kyc/tier1; ID_DOCUMENT and SELFIE to POST .../kyc/tier2; DATE_OF_BIRTH and ADDRESS to POST .../kyc/tier3; COUNTRY and ADDRESS_PROOF only ever appear from an open re-verification request. Empty when the next tier is already PENDING or in REVIEW, or every tier is APPROVED.
+ */
+export type PartnerVerificationInput = 'BVN' | 'NIN' | 'ID_DOCUMENT' | 'SELFIE' | 'DATE_OF_BIRTH' | 'ADDRESS' | 'COUNTRY' | 'ADDRESS_PROOF';
+
+export type PartnerVerificationSummaryDto = {
+    /**
+     * The highest APPROVED tier; 0 when none is.
+     */
+    currentTier: 0 | 1 | 2 | 3;
+    tiers: PartnerVerificationTiersDto;
+    /**
+     * What to submit next, in order. BVN and NIN go to POST .../kyc/tier1; ID_DOCUMENT and SELFIE to POST .../kyc/tier2; DATE_OF_BIRTH and ADDRESS to POST .../kyc/tier3; COUNTRY and ADDRESS_PROOF only ever appear from an open re-verification request. Empty when the next tier is already PENDING or in REVIEW, or every tier is APPROVED.
+     */
+    nextRequired: Array<PartnerVerificationInput>;
+    /**
+     * The open re-verification request an admin has raised, or null. Its items are already at the front of nextRequired.
+     */
+    reverification: PartnerReverificationRequestDto | null;
+    /**
+     * Every KYC record, newest first -- the same as GET .../kyc.
+     */
+    records: Array<PartnerKycRecordDto>;
+};
+
 export type PartnerKycSubmissionDto = {
     /**
      * APPROVED when the checks cleared immediately; REVIEW while a reviewer decides.
@@ -243,7 +300,7 @@ export type PartnerLedgerEntryDto = {
     id: string;
     type: LedgerEntryType;
     /**
-     * deposit | fiat.deposit | withdrawal | withdrawal.reversal | buy | sell | crypto_send | crypto_send.reversal | offramp.settlement | reversal
+     * deposit | fiat.deposit | withdrawal | withdrawal.fee | withdrawal.reversal | buy | sell | crypto_send | crypto_send.reversal | offramp.settlement | reversal
      */
     reason: string;
     currency: string;
@@ -264,6 +321,30 @@ export type PartnerLedgerEntryDto = {
     createdAt: string;
 };
 
+export type PartnerWithdrawalQuoteDto = {
+    currency: string;
+    /**
+     * What the bank account receives.
+     */
+    amount: number;
+    /**
+     * Withdrawal fee, same currency: the percentage fee on the amount plus the fixed fee for the currency.
+     */
+    fee: number;
+    /**
+     * amount + fee: what leaves the balance.
+     */
+    totalDebited: number;
+    /**
+     * Percentage part of the fee, basis points.
+     */
+    feeBps: number;
+    /**
+     * Fixed part of the fee, same currency.
+     */
+    feeFlat: number;
+};
+
 export type WithdrawalStatus = 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'PENDING_LIQUIDITY';
 
 export type PartnerWithdrawalBankAccountDto = {
@@ -276,9 +357,17 @@ export type PartnerWithdrawalDto = {
     id: string;
     reference: string;
     /**
-     * Decimal string, e.g. "5000.00000000".
+     * What the bank account receives. Decimal string, e.g. "5000.00000000".
      */
     amount: string;
+    /**
+     * Withdrawal fee charged on top of amount. Decimal string.
+     */
+    fee: string;
+    /**
+     * amount + fee: what left the balance. Decimal string.
+     */
+    totalDebited: string;
     currency: string;
     status: WithdrawalStatus;
     failureReason: string | null;
@@ -289,9 +378,13 @@ export type PartnerWithdrawalDto = {
 
 export type WithdrawDto = {
     /**
-     * Amount to withdraw
+     * Amount the bank account receives. The withdrawal fee is charged on top, so the balance is debited amount + fee.
      */
     amount: number;
+    /**
+     * Idempotency key. Resending the same value returns the existing withdrawal rather than moving money again — pass the client's request id. Letters, digits, dot, underscore and hyphen; 120 characters max.
+     */
+    reference?: string;
 };
 
 export type FundingChargeStatus = 'PENDING' | 'SUCCESS' | 'FAILED';
@@ -327,6 +420,10 @@ export type InitiateFundingChargeDto = {
      * Amount to fund, in the user’s local fiat (derived from their country).
      */
     amount: number;
+    /**
+     * Idempotency key. Resending the same value returns the existing funding charge rather than moving money again — pass the client's request id. Letters, digits, dot, underscore and hyphen; 120 characters max.
+     */
+    reference?: string;
 };
 
 /**
@@ -428,6 +525,10 @@ export type SendDto = {
      * Destination on-chain address
      */
     toAddress: string;
+    /**
+     * Idempotency key. Resending the same value returns the existing send rather than moving money again — pass the client's request id. Letters, digits, dot, underscore and hyphen; 120 characters max.
+     */
+    reference?: string;
 };
 
 export type PartnerCorridorDto = {
@@ -554,7 +655,7 @@ export type InitiateGlobalSendDto = {
     asset?: 'USDT' | 'USDC';
     beneficiary: GlobalSendBeneficiaryDto;
     /**
-     * Idempotency key. Resending the same value returns the existing send rather than debiting again — pass the client's request id.
+     * Idempotency key. Resending the same value returns the existing send rather than moving money again — pass the client's request id. Letters, digits, dot, underscore and hyphen; 120 characters max.
      */
     reference?: string;
 };
@@ -576,18 +677,9 @@ export type PartnerRampQuoteDto = {
      */
     rate: number;
     /**
-     * In the destination currency; 0 on a buy.
-     */
-    payoutFee: number;
-    /**
-     * In the destination currency; 0 on a buy.
-     */
-    networkGasFee: number;
-    /**
-     * In the destination currency; 0 on a buy.
+     * The exchange's fixed execution fee, in the destination currency; 0 on a buy.
      */
     exchangeFee: number;
-    network: BlockchainNetwork;
     /**
      * Seconds until the quote expires.
      */
@@ -599,7 +691,12 @@ export type GetQuoteDto = {
     sourceCurrency: string;
     destinationCurrency: string;
     type: 'sell' | 'buy';
-    network: 'ethereum' | 'polygon' | 'arbitrum' | 'base' | 'arc' | 'bsc' | 'optimism' | 'tron';
+    /**
+     * Ignored. A buy or sell moves balances only, so no chain is involved and no gas is charged; gas applies to crypto sends. Still accepted so older requests keep working.
+     *
+     * @deprecated
+     */
+    network?: 'ethereum' | 'polygon' | 'arbitrum' | 'base' | 'arc' | 'bsc' | 'optimism' | 'tron';
     /**
      * Optional preferred exchange venue. If omitted, the system auto-routes to the best available rate.
      */
@@ -635,23 +732,19 @@ export type PartnerNetworkDto = {
 export type PartnerRateDto = {
     fiatCurrency: string;
     /**
-     * Fiat per USDT when buying, spread applied.
+     * Fiat paid per USDT when buying. All-in: spread applied, and buys carry no fees.
      */
     buyRate: number;
     /**
-     * Fiat per USDT when selling, spread applied.
+     * Fiat received per USDT when selling. All-in: spread applied, plus the fixed exchange fee when ?amount was given, so amount * sellRate is exactly what the customer receives. The withdrawal fee is separate; see GET .../withdraw/quote.
      */
     sellRate: number;
     /**
-     * Sell-side payout fee, basis points of gross.
+     * USDT amount sellRate was priced for; null when ?amount was omitted, in which case the fixed exchange fee is not in sellRate.
      */
-    payoutFeeBps: number;
-    /**
-     * Sell-side gas estimate for the network, USD.
-     */
-    networkGasFeeUsd: number;
+    amount: number | null;
     /**
-     * Sell-side exchange fee, USDT.
+     * Fixed sell-side exchange fee, USDT. In sellRate only when ?amount was given.
      */
     exchangeFeeUsdt: number;
 };
@@ -660,12 +753,10 @@ export type PartnerSellResultDto = {
     reference: string;
     usdtSold: number;
     fiatCurrency: string;
-    fiatCredited: number;
-    settlementMode: SettlementMode;
     /**
-     * True when AUTO settlement already paid the proceeds to the default bank.
+     * Now on the customer's fiat balance; withdraw it with POST .../withdraw.
      */
-    autoWithdrawn: boolean;
+    fiatCredited: number;
 };
 
 export type PartnerBankDto = {
@@ -753,20 +844,6 @@ export type ResetPassword = {
     newPassword: string;
 };
 
-export type PartnerSettlementModeDto = {
-    /**
-     * AUTO pays sale proceeds straight to the default bank; MANUAL holds them as a fiat balance.
-     */
-    mode: SettlementMode;
-};
-
-export type SettlementModeDto = {
-    /**
-     * AUTO settles sale proceeds straight to the default bank; MANUAL holds them as an NGN balance to withdraw later.
-     */
-    mode: 'AUTO' | 'MANUAL';
-};
-
 export type PartnerReceivingAccountDto = {
     id: string;
     currency: string;
@@ -1007,6 +1084,27 @@ export type CustomersFullResponses = {
 
 export type CustomersFullResponse = CustomersFullResponses[keyof CustomersFullResponses];
 
+export type KycSummaryData = {
+    body?: never;
+    path: {
+        /**
+         * Id of one of your customers, as returned by customers.register.
+         */
+        customerId: string;
+    };
+    query?: never;
+    url: '/api/v1/partner/v1/customers/{customerId}/verification';
+};
+
+export type KycSummaryResponses = {
+    200: {
+        success: boolean;
+        data: PartnerVerificationSummaryDto;
+    };
+};
+
+export type KycSummaryResponse = KycSummaryResponses[keyof KycSummaryResponses];
+
 export type KycStatusData = {
     body?: never;
     path: {
@@ -1274,6 +1372,32 @@ export type WalletVirtualAccountForResponses = {
 
 export type WalletVirtualAccountForResponse = WalletVirtualAccountForResponses[keyof WalletVirtualAccountForResponses];
 
+export type WalletWithdrawalQuoteData = {
+    body?: never;
+    path: {
+        /**
+         * Id of one of your customers, as returned by customers.register.
+         */
+        customerId: string;
+    };
+    query: {
+        /**
+         * Amount the bank account would receive.
+         */
+        amount: number;
+    };
+    url: '/api/v1/partner/v1/customers/{customerId}/withdraw/quote';
+};
+
+export type WalletWithdrawalQuoteResponses = {
+    200: {
+        success: boolean;
+        data: PartnerWithdrawalQuoteDto;
+    };
+};
+
+export type WalletWithdrawalQuoteResponse = WalletWithdrawalQuoteResponses[keyof WalletWithdrawalQuoteResponses];
+
 export type WalletWithdrawData = {
     body: WithdrawDto;
     path: {
@@ -1572,9 +1696,15 @@ export type RampRateData = {
     };
     query?: {
         /**
-         * Chain the gas-fee estimate is quoted for. Only affects sell-side fees; buys are fee-free.
+         * Ignored. A buy or sell moves balances only, so no gas is priced into the rate; gas applies to crypto sends. Still accepted so older requests keep working.
+         *
+         * @deprecated
          */
         network?: 'ethereum' | 'polygon' | 'arbitrum' | 'base' | 'arc' | 'bsc' | 'optimism' | 'tron';
+        /**
+         * USDT amount to price the sell rate for. When given, the fixed exchange fee is spread over it, so amount * sellRate is exactly what the customer receives. Omit for a per-unit rate that carries the spread only.
+         */
+        amount?: number;
     };
     url: '/api/v1/partner/v1/customers/{customerId}/rate';
 };
@@ -1826,48 +1956,6 @@ export type ProfileChangePasswordResponses = {
 
 export type ProfileChangePasswordResponse = ProfileChangePasswordResponses[keyof ProfileChangePasswordResponses];
 
-export type ProfileGetSettlementModeData = {
-    body?: never;
-    path: {
-        /**
-         * Id of one of your customers, as returned by customers.register.
-         */
-        customerId: string;
-    };
-    query?: never;
-    url: '/api/v1/partner/v1/customers/{customerId}/settlement-mode';
-};
-
-export type ProfileGetSettlementModeResponses = {
-    200: {
-        success: boolean;
-        data: PartnerSettlementModeDto;
-    };
-};
-
-export type ProfileGetSettlementModeResponse = ProfileGetSettlementModeResponses[keyof ProfileGetSettlementModeResponses];
-
-export type ProfileSetSettlementModeData = {
-    body: SettlementModeDto;
-    path: {
-        /**
-         * Id of one of your customers, as returned by customers.register.
-         */
-        customerId: string;
-    };
-    query?: never;
-    url: '/api/v1/partner/v1/customers/{customerId}/settlement-mode';
-};
-
-export type ProfileSetSettlementModeResponses = {
-    200: {
-        success: boolean;
-        data: PartnerSettlementModeDto;
-    };
-};
-
-export type ProfileSetSettlementModeResponse = ProfileSetSettlementModeResponses[keyof ProfileSetSettlementModeResponses];
-
 export type ProfileWithdrawalsData = {
     body?: never;
     path: {