squarefi-bff-api-module 1.36.52 → 1.36.53

package/dist/api/types/autogen/apiV1External.types.d.ts

@@ -4236,6 +4236,8 @@ export interface paths {
                  *     - Missing required fields
                  *     - Invalid reference_id format
                  *     - Invalid amount (must be positive number)
+                 *     - `TOPUP_BELOW_MINIMUM` — credited amount is below the program's
+                 *       `min_topup` threshold (`error.details.min_topup`, program currency)
                  *      */
                 400: {
                     headers: {

package/dist/api/types/autogen/apiV1Frontend.types.d.ts

@@ -3632,7 +3632,10 @@ export interface paths {
                     };
                     content?: never;
                 };
-                /** @description Validation error */
+                /** @description Validation error. Includes `TOPUP_BELOW_MINIMUM` — credited amount is
+                 *     below the program's `min_topup` threshold (`error.details.min_topup`,
+                 *     program currency). No order created, wallet not debited.
+                 *      */
                 400: {
                     headers: {
                         [name: string]: unknown;
@@ -4283,6 +4286,9 @@ export interface paths {
                  *     - Invalid reference_id format
                  *     - Invalid amount (must be positive number)
                  *     - Insufficient wallet balance (`INSUFFICIENT_BALANCE`)
+                 *     - `TOPUP_BELOW_MINIMUM` — credited amount is below the program's
+                 *       `min_topup` threshold; `error.details.min_topup` carries the
+                 *       threshold (program currency). No order created, wallet not debited.
                  *      */
                 400: {
                     headers: {
@@ -13543,6 +13549,8 @@ export interface components {
             card_issuing_fee?: number | null;
             card_monthly_fee?: number | null;
             initial_topup?: number | null;
+            /** @description Minimum top-up amount in program currency, compared against the credited amount (0 = no minimum) */
+            min_topup?: number;
             card_design?: {
                 [key: string]: unknown;
             } | null;

package/dist/api/types/types.d.ts

@@ -115,6 +115,17 @@ export declare namespace API {
                 card_issuing_fee: number | null;
                 card_monthly_fee: number | null;
                 initial_topup: number | null;
+                /**
+                 * Minimum top-up in the program's currency, compared against the amount
+                 * CREDITED to the card (after fees and conversion) — the same figure the
+                 * server checks before it refuses a deposit with `TOPUP_BELOW_MINIMUM`.
+                 * `0` means the program sets no minimum. Does not apply to the initial
+                 * top-up at issuance.
+                 *
+                 * Optional on the type because programs served by a backend older than
+                 * the `issuing_programs.min_topup` migration omit it.
+                 */
+                min_topup?: number;
                 status?: IssuingProgramStatus | string;
             }
         }
@@ -270,7 +281,34 @@ export declare namespace API {
             adjustment_type: string;
             review_status: string;
             group: string;
+            /**
+             * What actually left the card: `billing_amount` plus `fee` for a debit
+             * (minus it for a credit, which arrives net of what the vendor keeps).
+             * Equals `billing_amount` when no fee sits inside the operation, so it is
+             * the figure to show as the transaction's amount.
+             */
             total_amount: number;
+            /**
+             * Fee charged INSIDE this operation, in billing currency. `0` for vendors
+             * that bill fees as their own transactions — those arrive as separate rows
+             * with `transaction_type: FEE`. Optional: older backends omit it.
+             */
+            fee?: number;
+            /** Vendor's itemisation of `fee`; empty when it gave none. */
+            fee_details?: TransactionFee[];
+            /**
+             * Units of billing currency per unit of transaction currency, so
+             * `transaction_amount * conversion_rate ≈ billing_amount`. 1 when the
+             * currencies match.
+             */
+            conversion_rate?: number;
+        }
+        /** One line of a transaction's fee itemisation (`TransactionItem.fee_details`). */
+        interface TransactionFee {
+            amount: number;
+            currency: string;
+            /** Vendor's own fee code — no cross-vendor meaning. */
+            type: string | null;
         }
         interface TransactionsList {
             data: TransactionItem[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "squarefi-bff-api-module",
-  "version": "1.36.52",
+  "version": "1.36.53",
   "description": "Squarefi BFF API client module",
   "type": "module",
   "main": "./dist/index.js",