squarefi-bff-api-module 1.36.0 → 1.36.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1261,7 +1261,7 @@ export interface paths {
1261
1261
  /** @description Sort direction */
1262
1262
  sort_order?: "ASC" | "DESC";
1263
1263
  /**
1264
- * @description Filter cards by exact last 4 digits of the card number (equality match against `issuing_cards.last4`).
1264
+ * @description Filter cards by last 4 digits of the card number (partial, case-insensitive match against `issuing_cards.last4`).
1265
1265
  * @example 1234
1266
1266
  */
1267
1267
  "filter[last4]"?: string;
@@ -1271,7 +1271,7 @@ export interface paths {
1271
1271
  * 3. For nested filtering: `filter[fiat_account][type]=prepaid`
1272
1272
  *
1273
1273
  * Common filter fields:
1274
- * - `last4`: Filter by last 4 digits of card (exact match)
1274
+ * - `last4`: Filter by last 4 digits of card (partial, case-insensitive match)
1275
1275
  * - `card_status`: Filter by status (ACTIVE, INACTIVE, CANCELED)
1276
1276
  * - `fiat_account.type`: Filter by account type (prepaid, balance)
1277
1277
  * - `from_created_at`: Filter cards created on or after this date (ISO 8601 format)
@@ -3183,25 +3183,7 @@ export interface paths {
3183
3183
  [name: string]: unknown;
3184
3184
  };
3185
3185
  content: {
3186
- "application/json": {
3187
- id?: string;
3188
- name?: string;
3189
- description?: string;
3190
- is_active?: boolean;
3191
- /** @description Associated KYC rails for this order type */
3192
- order_types_kyc_rails?: {
3193
- /**
3194
- * Format: uuid
3195
- * @description Unique identifier of the association
3196
- */
3197
- id?: string;
3198
- /**
3199
- * Format: uuid
3200
- * @description ID of the associated KYC rail
3201
- */
3202
- kyc_rail_id?: string;
3203
- }[];
3204
- }[];
3186
+ "application/json": components["schemas"]["OrderType"][];
3205
3187
  };
3206
3188
  };
3207
3189
  /** @description Server error */
@@ -3254,28 +3236,7 @@ export interface paths {
3254
3236
  [name: string]: unknown;
3255
3237
  };
3256
3238
  content: {
3257
- "application/json": {
3258
- id?: string;
3259
- name?: string;
3260
- description?: string;
3261
- is_active?: boolean;
3262
- direction?: string;
3263
- is_internal?: boolean;
3264
- payment_method?: string;
3265
- /** @description Associated KYC rails for this order type */
3266
- order_types_kyc_rails?: {
3267
- /**
3268
- * Format: uuid
3269
- * @description Unique identifier of the association
3270
- */
3271
- id?: string;
3272
- /**
3273
- * Format: uuid
3274
- * @description ID of the associated KYC rail
3275
- */
3276
- kyc_rail_id?: string;
3277
- }[];
3278
- };
3239
+ "application/json": components["schemas"]["OrderType"];
3279
3240
  };
3280
3241
  };
3281
3242
  /** @description Order type not found */
@@ -4783,39 +4744,7 @@ export interface paths {
4783
4744
  [name: string]: unknown;
4784
4745
  };
4785
4746
  content: {
4786
- "application/json": {
4787
- /** @description Order type identifier (e.g., EXCHANGE, WITHDRAWAL_CRYPTO) */
4788
- id?: string;
4789
- /** @description Human-readable description of the order type */
4790
- description?: string;
4791
- /** @description Direction of the order type (in/out) */
4792
- direction?: string;
4793
- /** @description Whether this is an internal order type */
4794
- is_internal?: boolean;
4795
- /**
4796
- * Format: uuid
4797
- * @description Associated KYC rail configuration ID
4798
- */
4799
- kyc_rails_id?: string | null;
4800
- /**
4801
- * @description Payment method associated with this order type
4802
- * @enum {string|null}
4803
- */
4804
- payment_method?: "FEDWIRE" | "ACH" | "SWIFT" | "SEPA" | "CHAPS" | "FPS" | "CRYPTO_EXTERNAL" | "CRYPTO_INTERNAL" | null;
4805
- /** @description Associated KYC rails for this order type */
4806
- order_types_kyc_rails?: {
4807
- /**
4808
- * Format: uuid
4809
- * @description Unique identifier of the association
4810
- */
4811
- id?: string;
4812
- /**
4813
- * Format: uuid
4814
- * @description ID of the associated KYC rail
4815
- */
4816
- kyc_rail_id?: string;
4817
- }[];
4818
- }[];
4747
+ "application/json": components["schemas"]["OrderType"][];
4819
4748
  };
4820
4749
  };
4821
4750
  /** @description Server error */
@@ -4868,39 +4797,7 @@ export interface paths {
4868
4797
  [name: string]: unknown;
4869
4798
  };
4870
4799
  content: {
4871
- "application/json": {
4872
- /** @description Order type identifier (e.g., EXCHANGE, WITHDRAWAL_CRYPTO) */
4873
- id?: string;
4874
- /** @description Human-readable description of the order type */
4875
- description?: string;
4876
- /** @description Direction of the order type (in/out) */
4877
- direction?: string;
4878
- /** @description Whether this is an internal order type */
4879
- is_internal?: boolean;
4880
- /**
4881
- * Format: uuid
4882
- * @description Associated KYC rail configuration ID
4883
- */
4884
- kyc_rails_id?: string | null;
4885
- /**
4886
- * @description Payment method associated with this order type
4887
- * @enum {string|null}
4888
- */
4889
- payment_method?: "FEDWIRE" | "ACH" | "SWIFT" | "SEPA" | "CHAPS" | "FPS" | "CRYPTO_EXTERNAL" | "CRYPTO_INTERNAL" | null;
4890
- /** @description Associated KYC rails for this order type */
4891
- order_types_kyc_rails?: {
4892
- /**
4893
- * Format: uuid
4894
- * @description Unique identifier of the association
4895
- */
4896
- id?: string;
4897
- /**
4898
- * Format: uuid
4899
- * @description ID of the associated KYC rail
4900
- */
4901
- kyc_rail_id?: string;
4902
- }[];
4903
- };
4800
+ "application/json": components["schemas"]["OrderType"];
4904
4801
  };
4905
4802
  };
4906
4803
  /** @description Order type not found */
@@ -8390,6 +8287,74 @@ export interface components {
8390
8287
  * @enum {string}
8391
8288
  */
8392
8289
  OrderTypeId: "EXCHANGE_OMNI" | "EXCHANGE_OMNI_ONRAMP" | "EXCHANGE_OMNI_OFFRAMP" | "EXCHANGE_OMNI_CRYPTO" | "EXCHANGE_CRYPTO_INTERNAL" | "L2F_ACH_ONRAMP" | "L2F_ACH_OFFRAMP" | "L2F_SEPA_ONRAMP" | "L2F_SEPA_OFFRAMP" | "L2F_SWIFT_ONRAMP" | "L2F_SWIFT_OFFRAMP" | "L2F_WIRE_ONRAMP" | "L2F_WIRE_OFFRAMP" | "L2F_CHAPS_ONRAMP" | "L2F_CHAPS_OFFRAMP" | "L2F_FPS_ONRAMP" | "L2F_FPS_OFFRAMP" | "BRL_WIRE_ONRAMP" | "BRL_WIRE_OFFRAMP" | "BRL_ACH_ONRAMP" | "BRL_ACH_OFFRAMP" | "OMNIBUS_CRYPTO_TRANSFER" | "OMNIBUS_CRYPTO_WITHDRAWAL" | "OMNIBUS_INTERNAL_TRANSFER" | "SEGREGATED_CRYPTO_TRANSFER" | "TRANSFER_INTERNAL" | "TRANSFER_CARD_PREPAID" | "TRANSFER_CARD_SUBACCOUNT" | "TRANSFER_CARD_WHOLESALE" | "WITHDRAW_CARD_PREPAID" | "WITHDRAW_CARD_SUBACCOUNT" | "REFUND_CARD_PREPAID" | "REFUND_CARD_SUBACCOUNT" | "RN_CARDS_OFFRAMP" | "CARD_ISSUING_FEE";
8290
+ /** @description Order type reference with optional product guardrails, associated KYC rails and tenant billing rates */
8291
+ OrderType: {
8292
+ /** @description Order type identifier (e.g. EXCHANGE, WITHDRAWAL_CRYPTO) */
8293
+ id?: string;
8294
+ /** @description Human-readable name of the order type */
8295
+ name?: string | null;
8296
+ /** @description Human-readable description of the order type */
8297
+ description?: string;
8298
+ /** @description Direction of the order type (in/out) */
8299
+ direction?: string | null;
8300
+ /** @description Whether this is an internal order type */
8301
+ is_internal?: boolean;
8302
+ /** @description Whether this order type is trusted */
8303
+ is_trusted?: boolean;
8304
+ /**
8305
+ * @description Payment method associated with this order type
8306
+ * @enum {string|null}
8307
+ */
8308
+ payment_method?: "DOMESTIC_WIRE" | "FEDWIRE" | "ACH" | "SWIFT" | "SEPA" | "CHAPS" | "FPS" | "CRYPTO_EXTERNAL" | "CRYPTO_INTERNAL" | null;
8309
+ /**
8310
+ * Format: uuid
8311
+ * @description Associated KYC rail configuration ID
8312
+ */
8313
+ kyc_rails_id?: string | null;
8314
+ /**
8315
+ * @description Optional minimum amount the product should allow for this order type
8316
+ * @example 100
8317
+ */
8318
+ min_amount?: number | null;
8319
+ /**
8320
+ * @description Optional maximum amount the product should allow for this order type
8321
+ * @example 50000
8322
+ */
8323
+ max_amount?: number | null;
8324
+ /** @description Whether payouts for this order type are limited to the wallet owner's own account */
8325
+ first_party_only?: boolean;
8326
+ /** @description Associated KYC rails for this order type */
8327
+ order_types_kyc_rails?: {
8328
+ /**
8329
+ * Format: uuid
8330
+ * @description Unique identifier of the association
8331
+ */
8332
+ id?: string;
8333
+ /**
8334
+ * Format: uuid
8335
+ * @description ID of the associated KYC rail
8336
+ */
8337
+ kyc_rail_id?: string;
8338
+ }[];
8339
+ /** @description Tenant-specific billing rates (present when tenant context is available) */
8340
+ tenant_rates?: {
8341
+ /**
8342
+ * @description Percentage markup on order volume
8343
+ * @example 1.8
8344
+ */
8345
+ markup_percent?: number;
8346
+ /**
8347
+ * @description Fixed fee per order (USD)
8348
+ * @example 0
8349
+ */
8350
+ markup_fixed?: number;
8351
+ /**
8352
+ * @description Minimum monthly payment (USD)
8353
+ * @example 0
8354
+ */
8355
+ mon_min_usd?: number;
8356
+ } | null;
8357
+ };
8393
8358
  SubAccount: {
8394
8359
  /**
8395
8360
  * @description Unique identifier for the sub-account
@@ -3761,7 +3761,9 @@ export interface paths {
3761
3761
  * - When the request is scoped to a tenant (via `x-tenant-id` header or session),
3762
3762
  * the list is **filtered** to order types enabled for that tenant —
3763
3763
  * i.e. those having a row in `tenant_order_type_rates`. Each returned item is
3764
- * enriched with `tenant_rates` (`markup_percent`, `markup_fixed`, `mon_min_usd`).
3764
+ * enriched with `tenant_rates` (`markup_percent`, `markup_fixed`, `mon_min_usd`)
3765
+ * and may expose product-facing guardrails such as `min_amount`,
3766
+ * `max_amount`, and `first_party_only`.
3765
3767
  * - Without a tenant scope (admin global view), the full catalogue is returned
3766
3768
  * and `tenant_rates` is omitted.
3767
3769
  *
@@ -7609,11 +7611,25 @@ export interface components {
7609
7611
  is_internal?: boolean;
7610
7612
  payment_method?: string | null;
7611
7613
  is_trusted?: boolean;
7614
+ /**
7615
+ * @description Optional minimum amount the product should allow for this order type
7616
+ * @example 100
7617
+ */
7618
+ min_amount?: number | null;
7619
+ /**
7620
+ * @description Optional maximum amount the product should allow for this order type
7621
+ * @example 50000
7622
+ */
7623
+ max_amount?: number | null;
7624
+ /** @description Whether payouts for this order type are limited to the wallet owner's own account */
7625
+ first_party_only?: boolean;
7612
7626
  kyc_rails?: {
7613
7627
  /** Format: uuid */
7614
7628
  id?: string;
7615
7629
  type?: string;
7616
7630
  name?: string;
7631
+ /** @description When false, deposits are not accepted for accounts on this rail and their requisites are suppressed in public responses */
7632
+ is_deposit_enabled?: boolean;
7617
7633
  } | null;
7618
7634
  /** @description Tenant-specific billing rates */
7619
7635
  tenant_rates?: {
@@ -7722,6 +7738,8 @@ export interface components {
7722
7738
  account_currency?: string;
7723
7739
  /** Format: uuid */
7724
7740
  destination_currency?: string;
7741
+ /** @description Whether deposits are enabled for this account, resolved from the account's KYC rail (virtual_accounts_programs.kyc_rails.is_deposit_enabled). When false, public (Frontend/Developer) responses suppress deposit_instructions/account_details; admin responses still expose them. */
7742
+ is_deposit_enabled?: boolean;
7725
7743
  /** @description Bank deposit instructions grouped by instruction type (ACH, FEDWIRE, SWIFT) */
7726
7744
  deposit_instructions?: {
7727
7745
  /**