squarefi-bff-api-module 1.36.63 → 1.36.65

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.
@@ -461,6 +461,8 @@ export interface paths {
461
461
  sort_order?: "ASC" | "DESC";
462
462
  /** @description JSON string of filters to apply. Example - [{"status":"complete"},{"type":"deposit"}] */
463
463
  filters?: string;
464
+ /** @description When false (default), dust transactions below threshold are hidden */
465
+ show_low_balance?: boolean;
464
466
  };
465
467
  header?: never;
466
468
  path: {
@@ -581,6 +583,8 @@ export interface paths {
581
583
  from_date?: string;
582
584
  /** @description Filter transactions up to this date (inclusive). Format - ISO 8601 (e.g., 2024-12-31T23:59:59Z) */
583
585
  to_date?: string;
586
+ /** @description When false (default), dust transactions below threshold are hidden */
587
+ show_low_balance?: boolean;
584
588
  };
585
589
  header?: never;
586
590
  path: {
@@ -639,6 +643,8 @@ export interface paths {
639
643
  to_date?: string;
640
644
  /** @description Optional access token for additional security */
641
645
  access_token?: string;
646
+ /** @description When false (default), dust transactions below threshold are hidden */
647
+ show_low_balance?: boolean;
642
648
  };
643
649
  header?: never;
644
650
  path: {
@@ -706,6 +712,8 @@ export interface paths {
706
712
  to_date?: string;
707
713
  /** @description Filter by specific currency UUID. If provided, generates statement only for this currency. */
708
714
  crypto_id?: string;
715
+ /** @description When false (default), dust transactions below threshold are hidden */
716
+ show_low_balance?: boolean;
709
717
  /**
710
718
  * @deprecated
711
719
  * @description [DEPRECATED] Ignored. Branding is derived from the wallet tenant. Sending this parameter triggers a `Deprecation: true` response header.
@@ -1113,7 +1121,9 @@ export interface paths {
1113
1121
  *
1114
1122
  * Common filter fields:
1115
1123
  * - `last4`: Filter by last 4 digits of card (partial, case-insensitive match)
1116
- * - `card_status`: Filter by status (ACTIVE, INACTIVE, CANCELED)
1124
+ * - `card_status`: Filter by status (ACTIVE, INACTIVE, CANCELED). Cards whose
1125
+ * creation the vendor refused (FAILED with no card behind them) are left out
1126
+ * of the listing unless you ask for them with `card_status=FAILED`.
1117
1127
  * - `fiat_account.type`: Filter by account type (prepaid, balance)
1118
1128
  * - `from_created_at`: Filter cards created on or after this date (ISO 8601 format)
1119
1129
  * - `to_created_at`: Filter cards created on or before this date (ISO 8601 format)
@@ -2956,9 +2966,9 @@ export interface paths {
2956
2966
  */
2957
2967
  get: {
2958
2968
  parameters: {
2959
- query?: {
2960
- /** @description Order type (EXCHANGE, WITHDRAWAL_CRYPTO, etc) */
2961
- order_type?: string;
2969
+ query: {
2970
+ /** @description Order type the rates are resolved for */
2971
+ order_type: components["schemas"]["OrderTypeId"];
2962
2972
  };
2963
2973
  header?: never;
2964
2974
  path?: never;
@@ -2966,18 +2976,13 @@ export interface paths {
2966
2976
  };
2967
2977
  requestBody?: never;
2968
2978
  responses: {
2969
- /** @description User rates */
2979
+ /** @description User rates (the rates object itself, without a `success`/`data` envelope) */
2970
2980
  200: {
2971
2981
  headers: {
2972
2982
  [name: string]: unknown;
2973
2983
  };
2974
2984
  content: {
2975
- "application/json": {
2976
- rates?: {
2977
- order_type?: string;
2978
- rate?: number;
2979
- }[];
2980
- };
2985
+ "application/json": components["schemas"]["IndividualRates"];
2981
2986
  };
2982
2987
  };
2983
2988
  /** @description Server error */
@@ -3169,21 +3174,13 @@ export interface paths {
3169
3174
  };
3170
3175
  requestBody?: never;
3171
3176
  responses: {
3172
- /** @description Order calculation details */
3177
+ /** @description Order calculation details (the calculation object itself, without a `success`/`data` envelope) */
3173
3178
  200: {
3174
3179
  headers: {
3175
3180
  [name: string]: unknown;
3176
3181
  };
3177
3182
  content: {
3178
- "application/json": {
3179
- exchange_rate?: number;
3180
- result_amount?: number;
3181
- commission?: number;
3182
- commission_rate?: number;
3183
- individual_rate?: number;
3184
- network_fee?: number;
3185
- net_amount?: number;
3186
- };
3183
+ "application/json": components["schemas"]["OrderCalculation"];
3187
3184
  };
3188
3185
  };
3189
3186
  /** @description Bad request */
@@ -4297,9 +4294,9 @@ export interface paths {
4297
4294
  */
4298
4295
  get: {
4299
4296
  parameters: {
4300
- query?: {
4301
- /** @description Order type (EXCHANGE, WITHDRAWAL_CRYPTO, etc) */
4302
- order_type?: string;
4297
+ query: {
4298
+ /** @description Order type the rates are resolved for */
4299
+ order_type: components["schemas"]["OrderTypeId"];
4303
4300
  };
4304
4301
  header?: never;
4305
4302
  path?: never;
@@ -4314,10 +4311,20 @@ export interface paths {
4314
4311
  };
4315
4312
  content: {
4316
4313
  "application/json": {
4317
- rates?: {
4318
- order_type?: string;
4319
- rate?: number;
4320
- }[];
4314
+ /** @example true */
4315
+ success?: boolean;
4316
+ data?: components["schemas"]["IndividualRates"];
4317
+ };
4318
+ };
4319
+ };
4320
+ /** @description Missing `order_type`, or no tariff configured for it (`TENANT_FEE_NOT_CONFIGURED`) */
4321
+ 400: {
4322
+ headers: {
4323
+ [name: string]: unknown;
4324
+ };
4325
+ content: {
4326
+ "application/json": {
4327
+ error?: string;
4321
4328
  };
4322
4329
  };
4323
4330
  };
@@ -4854,7 +4861,8 @@ export interface paths {
4854
4861
  * - Filter by status: `[{"status":"COMPLETE"}]`
4855
4862
  * - Filter by order type: `[{"order_type":"EXCHANGE"}]`
4856
4863
  * - Multiple filters: `[{"status":"PENDING"},{"order_type":"L2F_WIRE_OFFRAMP"}]`
4857
- * - Filter by meta field: `[{"meta":{"workflow_status":"PROCESSING"}}]`
4864
+ * - Filter by meta field: `[{"meta->>workflow_status":"PROCESSING"}]`
4865
+ * - Find an order by your own reference: `[{"meta->>reference":"invoice-2026-04-001"}]`
4858
4866
  *
4859
4867
  */
4860
4868
  get: {
@@ -4878,12 +4886,13 @@ export interface paths {
4878
4886
  * - `order_type` - Order type (EXCHANGE, WITHDRAWAL_CRYPTO, L2F_WIRE_OFFRAMP, etc.)
4879
4887
  * - `from_uuid` - Source currency UUID
4880
4888
  * - `to_uuid` - Destination currency UUID
4881
- * - `meta` - Nested JSONB filters (e.g., {"meta":{"workflow_status":"PROCESSING"}})
4889
+ * - `meta->>key` - JSONB meta field by key with the text operator (e.g., {"meta->>workflow_status":"PROCESSING"})
4882
4890
  *
4883
4891
  * **Examples:**
4884
4892
  * - Single value: `[{"status":"COMPLETE"}]`
4885
4893
  * - Multiple values (OR): `[{"status":["PENDING","PROCESSING"]}]`
4886
- * - Nested JSONB: `[{"meta":{"workflow_status":"PROCESSING"}}]`
4894
+ * - JSONB meta field: `[{"meta->>workflow_status":"PROCESSING"}]`
4895
+ * - By your own reference: `[{"meta->>reference":"invoice-2026-04-001"}]`
4887
4896
  *
4888
4897
  * @example [{"status":"COMPLETE"}]
4889
4898
  */
@@ -5235,13 +5244,9 @@ export interface paths {
5235
5244
  };
5236
5245
  content: {
5237
5246
  "application/json": {
5238
- exchange_rate?: number;
5239
- result_amount?: number;
5240
- commission?: number;
5241
- commission_rate?: number;
5242
- individual_rate?: number;
5243
- network_fee?: number;
5244
- net_amount?: number;
5247
+ /** @example true */
5248
+ success: boolean;
5249
+ data: components["schemas"]["OrderCalculation"];
5245
5250
  };
5246
5251
  };
5247
5252
  };
@@ -7168,6 +7173,170 @@ export interface components {
7168
7173
  * @enum {string}
7169
7174
  */
7170
7175
  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" | "BRL_RTP_OFFRAMP" | "DLS_WIRE_ONRAMP" | "DLS_WIRE_OFFRAMP" | "DLS_ACH_ONRAMP" | "DLS_ACH_OFFRAMP" | "DLS_SEPA_ONRAMP" | "DLS_SEPA_OFFRAMP" | "DLS_SWIFT_ONRAMP" | "DLS_SWIFT_OFFRAMP" | "BC1_SEPA_ONRAMP" | "BC1_SEPA_OFFRAMP" | "BC1_SWIFT_ONRAMP" | "BC1_SWIFT_OFFRAMP" | "BC3_SEPA_ONRAMP" | "BC3_SEPA_OFFRAMP" | "RPP_SWIFT_OFFRAMP" | "RPP_SEPA_OFFRAMP" | "RPP_FPS_OFFRAMP" | "RPP_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" | "MONTHLY_FEE";
7176
+ OrderCalculation: {
7177
+ /**
7178
+ * Format: uuid
7179
+ * @description Source currency UUID.
7180
+ */
7181
+ from_currency: string;
7182
+ /**
7183
+ * Format: uuid
7184
+ * @description Destination currency UUID.
7185
+ */
7186
+ to_currency: string;
7187
+ /**
7188
+ * @description Source currency symbol.
7189
+ * @example USDT
7190
+ */
7191
+ from_symbol: string;
7192
+ /**
7193
+ * @description Destination currency symbol.
7194
+ * @example USD
7195
+ */
7196
+ to_symbol: string;
7197
+ /**
7198
+ * @description Decimals the source-currency amounts are truncated to.
7199
+ * @example 6
7200
+ */
7201
+ from_decimals: number;
7202
+ /**
7203
+ * @description Decimals the destination-currency amounts are truncated to.
7204
+ * @example 2
7205
+ */
7206
+ to_decimals: number;
7207
+ /**
7208
+ * @description Amount to be spent in the source currency.
7209
+ * @example 100
7210
+ */
7211
+ from_amount: number;
7212
+ /**
7213
+ * @description Amount to be received in the destination currency.
7214
+ * @example 98.5
7215
+ */
7216
+ result_amount: number;
7217
+ /**
7218
+ * @description Amount converted before fees, in the destination currency.
7219
+ * @example 100
7220
+ */
7221
+ net_amount: number;
7222
+ /**
7223
+ * @description Total fees (`comission` + `network_fee`), in the source currency.
7224
+ * @example 1.5
7225
+ */
7226
+ fees: number;
7227
+ /**
7228
+ * @description Service commission excluding the network fee (wire name is intentionally `comission`).
7229
+ * @example 1.5
7230
+ */
7231
+ comission: number;
7232
+ /**
7233
+ * Format: uuid
7234
+ * @description Currency UUID `comission` is denominated in. Omitted by older engines — then it is the same currency on both sides.
7235
+ */
7236
+ commission_currency?: string;
7237
+ /**
7238
+ * @description Percentage part of the commission, in the commission currency.
7239
+ * @example 1
7240
+ */
7241
+ percent_commission: number;
7242
+ /**
7243
+ * @description Fixed part of the commission, in the commission currency.
7244
+ * @example 0.5
7245
+ */
7246
+ fixed_commission: number;
7247
+ /**
7248
+ * @description Markup applied, in whole percent.
7249
+ * @example 1.5
7250
+ */
7251
+ base_markup: number;
7252
+ /**
7253
+ * @description Estimated blockchain network fee in the source currency (crypto withdrawals only, otherwise 0).
7254
+ * @example 0
7255
+ */
7256
+ network_fee: number;
7257
+ /**
7258
+ * @description Network fee in the chain native currency (ETH, BNB, …), 18 decimals.
7259
+ * @example 0
7260
+ */
7261
+ network_fee_native: number;
7262
+ /**
7263
+ * @description Network fee in USD, 8 decimals.
7264
+ * @example 0
7265
+ */
7266
+ network_fee_usd: number;
7267
+ /**
7268
+ * @description Transaction fee. Always 0 for now.
7269
+ * @example 0
7270
+ */
7271
+ transaction_fee: number;
7272
+ /**
7273
+ * @description Exchange rate applied (source → destination), 6 decimals. Includes the tenant FX spread.
7274
+ * @example 0.985
7275
+ */
7276
+ rate: number;
7277
+ /**
7278
+ * @description Market rate before the tenant FX spread. Equal to `rate` when no spread applies.
7279
+ * @example 1
7280
+ */
7281
+ base_rate: number;
7282
+ /**
7283
+ * @description Tenant FX spread already taken off `rate`, in whole percent.
7284
+ * @example 1.5
7285
+ */
7286
+ fx_spread: number;
7287
+ /**
7288
+ * @description Percent markup of the applied tariff.
7289
+ * @example 1.5
7290
+ */
7291
+ markup: number;
7292
+ /**
7293
+ * @description Fixed USD markup of the applied tariff.
7294
+ * @example 0.5
7295
+ */
7296
+ markup_usd: number;
7297
+ /**
7298
+ * @description Percent markup on the network fee.
7299
+ * @example 0
7300
+ */
7301
+ gas_markup: number;
7302
+ /**
7303
+ * @description Percent discount on the network fee.
7304
+ * @example 0
7305
+ */
7306
+ gas_discount: number;
7307
+ /** @description Whether the order type is an internal (on-platform) operation. */
7308
+ is_internal: boolean;
7309
+ /** @description Whether the operation is allowed for the caller with these inputs. */
7310
+ allowed: boolean;
7311
+ /** @description Calculation error text, `null` on success. */
7312
+ error: string | null;
7313
+ };
7314
+ IndividualRates: {
7315
+ /**
7316
+ * @description Percent commission applied to the amount.
7317
+ * @example 1.5
7318
+ */
7319
+ markup: number;
7320
+ /**
7321
+ * @description Fixed commission in USD.
7322
+ * @example 0.5
7323
+ */
7324
+ markup_usd: number;
7325
+ /**
7326
+ * @description Percent markup on the network fee.
7327
+ * @example 0
7328
+ */
7329
+ gas_markup: number;
7330
+ /**
7331
+ * @description Percent discount on the network fee.
7332
+ * @example 0
7333
+ */
7334
+ gas_discount: number;
7335
+ /** @description Order type the resolved tariff row belongs to. Absent for the zero-fee internal transfer. */
7336
+ order_type?: string;
7337
+ } & {
7338
+ [key: string]: unknown;
7339
+ };
7171
7340
  /** @description Order type reference with optional product guardrails, associated KYC rails and tenant billing rates */
7172
7341
  OrderType: {
7173
7342
  /** @description Order type identifier (e.g. EXCHANGE, WITHDRAWAL_CRYPTO) */