btrz-api-client 8.32.0 → 8.34.0

package/lib/endpoints/btrzpay/oxxo.js

@@ -6,11 +6,31 @@ var _require = require("./../endpoints_helpers.js"),
 /**
  * Query params for GET /oxxo/:token/payments (btrz-api-payments). See get-payments-handler getSpec().
  * @typedef {Object} OxxoPaymentsListQuery
- * @property {string} [referenceNumber] - Payment reference number
+ * @property {string} referenceNumber - Payment reference number (required)
  */
 
 /**
- * Factory for OXXO API (btrz-api-payments).
+ * Request body for POST /oxxo/:token/payments/:referenceNumber. PostOxxoPaymentsPayload.
+ * @typedef {Object} PostOxxoPaymentsPayload
+ * @property {string} ticket - Oxxo sale ticket id
+ * @property {number} amount - Amount to pay in cents
+ * @property {string} folio - FEMSA transaction id
+ * @property {string} store - Store id
+ * @property {string} account - Account id (ObjectId)
+ */
+
+/**
+ * Request body for POST /oxxo/:token/reverse/:referenceNumber. PostOxxoReversePayload.
+ * @typedef {Object} PostOxxoReversePayload
+ * @property {string} ticket - Oxxo sale ticket id
+ * @property {number} amount - Amount in cents
+ * @property {string} folio - FEMSA transaction id
+ * @property {string} store - Store id
+ * @property {string} account - Account id (ObjectId)
+ */
+
+/**
+ * Factory for OXXO API (btrz-api-payments). Endpoints are hideInDocumentation; client for internal use.
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
@@ -20,64 +40,71 @@ var _require = require("./../endpoints_helpers.js"),
 
 function oxxoFactory(_ref) {
   var client = _ref.client,
-      _internalAuthTokenProvider = _ref.internalAuthTokenProvider;
+      internalAuthTokenProvider = _ref.internalAuthTokenProvider;
+
+  function authProvider(opts) {
+    return opts !== undefined && opts !== null ? opts : internalAuthTokenProvider;
+  }
 
   var token = {
     /**
-     * GET /oxxo/token - get OXXO token. API does not accept query params.
+     * GET /oxxo/token - get new Oxxo token. No query params.
      * @param {Object} opts
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {{ getToken: function(): string }} [opts.internalAuthTokenProvider]
      * @param {Object} [opts.headers] - Optional request headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse<{ token: string }>>}
+     *   GetOxxoTokenResponse. Rejects with 401, 500.
      */
     get: function get(_ref2) {
       var jwtToken = _ref2.jwtToken,
           headers = _ref2.headers,
-          internalAuthTokenProvider = _ref2.internalAuthTokenProvider;
+          optsAuth = _ref2.internalAuthTokenProvider;
 
       return client({
         url: "/oxxo/token",
-        headers: authorizationHeaders({ jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
+        headers: authorizationHeaders({ jwtToken: jwtToken, internalAuthTokenProvider: authProvider(optsAuth), headers: headers })
       });
     }
   };
 
   var payments = {
     /**
-     * GET /oxxo/:oxxoToken/payments - list OXXO payments.
+     * GET /oxxo/:token/payments - list Oxxo payments by token and reference number.
      * @param {Object} opts
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.oxxoToken - OXXO token
-     * @param {OxxoPaymentsListQuery} [opts.query] - Query params (referenceNumber)
+     * @param {string} opts.oxxoToken - Oxxo token
+     * @param {OxxoPaymentsListQuery} opts.query - referenceNumber (required)
      * @param {{ getToken: function(): string }} [opts.internalAuthTokenProvider]
      * @param {Object} [opts.headers] - Optional request headers
-     * @returns {Promise<import("axios").AxiosResponse>} GetOxxoPaymentsResponse; 400 ERROR_GETTING_PAYMENT_METHODS
+     * @returns {Promise<import("axios").AxiosResponse<{ payments: Array }>>}
+     *   GetOxxoPaymentsResponse. Rejects with 400 (ERROR_GETTING_PAYMENT_METHODS, OXXO_PAY_NOT_ENABLED), 401, 500.
      */
     all: function all(_ref3) {
       var jwtToken = _ref3.jwtToken,
           headers = _ref3.headers,
           oxxoToken = _ref3.oxxoToken,
           query = _ref3.query,
-          internalAuthTokenProvider = _ref3.internalAuthTokenProvider;
+          optsAuth = _ref3.internalAuthTokenProvider;
 
       return client({
         url: "/oxxo/" + oxxoToken + "/payments",
         params: query,
-        headers: authorizationHeaders({ jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
+        headers: authorizationHeaders({ jwtToken: jwtToken, internalAuthTokenProvider: authProvider(optsAuth), headers: headers })
       });
     },
 
     /**
-     * POST /oxxo/:oxxoToken/payments/:referenceNumber - update OXXO payment. API does not accept query params.
+     * POST /oxxo/:token/payments/:referenceNumber - pay Oxxo payment (referenceNumber: UUID v4 or 20 digits).
      * @param {Object} opts
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.oxxoToken - OXXO token
+     * @param {string} opts.oxxoToken - Oxxo token
      * @param {string} opts.referenceNumber - Payment reference number
-     * @param {Object} opts.data - Request body (PostOxxoPaymentsPayload)
+     * @param {PostOxxoPaymentsPayload|{ oxxoInfo: PostOxxoPaymentsPayload }} opts.data - Request body
      * @param {{ getToken: function(): string }} [opts.internalAuthTokenProvider]
      * @param {Object} [opts.headers] - Optional request headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse<{ payment: Object }>>}
+     *   Rejects with 400 (INVALID_REFERENCE_NUMBER_FORMAT, INVALID_ACCOUNT, OXXO_PAY_NOT_ENABLED), 401, 500.
      */
     update: function update(_ref4) {
       var jwtToken = _ref4.jwtToken,
@@ -86,37 +113,36 @@ function oxxoFactory(_ref) {
           query = _ref4.query,
           referenceNumber = _ref4.referenceNumber,
           data = _ref4.data,
-          internalAuthTokenProvider = _ref4.internalAuthTokenProvider;
+          optsAuth = _ref4.internalAuthTokenProvider;
 
       return client({
         url: "/oxxo/" + oxxoToken + "/payments/" + referenceNumber,
         method: "post",
         params: query,
         data: data,
-        headers: authorizationHeaders({ jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
+        headers: authorizationHeaders({ jwtToken: jwtToken, internalAuthTokenProvider: authProvider(optsAuth), headers: headers })
       });
     },
 
     /**
-     * POST /oxxo/:oxxoToken/reverse/:referenceNumber - reverse OXXO payment. API does not accept query params.
+     * POST /oxxo/:token/reverse/:referenceNumber - reverse Oxxo payment (referenceNumber: UUID v4 or 20 digits).
      * @param {Object} opts
-     * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.oxxoToken - OXXO token
+     * @param {string} opts.oxxoToken - Oxxo token
      * @param {string} opts.referenceNumber - Payment reference number
-     * @param {Object} [opts.data] - Request body (PostOxxoReversePayload)
+     * @param {PostOxxoReversePayload|{ oxxoInfo: PostOxxoReversePayload }} [opts.data] - Request body
      * @param {{ getToken: function(): string }} [opts.internalAuthTokenProvider]
      * @param {Object} [opts.headers] - Optional request headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse<{ payment: Object }>>}
+     *   Rejects with 400 (INVALID_REFERENCE_NUMBER_FORMAT, INVALID_ACCOUNT, OXXO_PAY_NOT_ENABLED), 401, 500.
      */
     reverse: function reverse(_ref5) {
-      var authToken = _ref5.token,
-          jwtToken = _ref5.jwtToken,
+      var jwtToken = _ref5.jwtToken,
           headers = _ref5.headers,
           query = _ref5.query,
           referenceNumber = _ref5.referenceNumber,
           data = _ref5.data,
-          internalAuthTokenProvider = _ref5.internalAuthTokenProvider,
+          optsAuth = _ref5.internalAuthTokenProvider,
           oxxoToken = _ref5.oxxoToken;
 
       return client({
@@ -124,7 +150,7 @@ function oxxoFactory(_ref) {
         method: "post",
         params: query,
         data: data,
-        headers: authorizationHeaders({ token: authToken, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
+        headers: authorizationHeaders({ jwtToken: jwtToken, internalAuthTokenProvider: authProvider(optsAuth), headers: headers })
       });
     }
   };

package/lib/endpoints/btrzpay/prismaTerminals.js

@@ -4,10 +4,11 @@ var _require = require("../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
 /**
- * Query params for GET payment/reversal/refund and PUT refund (btrz-api-payments). See get-by-id-* and put-refunds getSpec().
+ * Query params for Prisma terminals endpoints (btrz-api-payments).
  * @typedef {Object} PrismaTerminalsQuery
  * @property {string} [providerId] - Account provider (operator) ID; used by agencies/sellers
  * @property {boolean} [validateRefund] - (PUT refunds only) If true, fetch current state from Prisma before applying
+ * @property {boolean} [validatePayment] - (PUT payments only) If true, validate payment against the provider
  */
 
 /**
@@ -49,12 +50,13 @@ function prismaTerminalsFactory(_ref) {
     },
 
     /**
-     * POST /prisma-terminals/payments/:id/reversals - create reversal. API does not accept query params.
+     * POST /prisma-terminals/payments/:id/reversals - create reversal.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.id - Payment id
+     * @param {string} opts.id - Payment id (prismaPaymentId)
      * @param {Object} opts.prismaReversal - Prisma reversal payload
+     * @param {PrismaTerminalsQuery} [opts.query] - Query params (providerId)
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */
@@ -77,11 +79,12 @@ function prismaTerminalsFactory(_ref) {
     },
 
     /**
-     * DELETE /prisma-terminals/reversals/:id - delete reversal. API does not accept query params.
+     * DELETE /prisma-terminals/reversals/:id - delete reversal.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.id - Reversal id
+     * @param {string} opts.id - Reversal id (prismaPaymentId)
+     * @param {PrismaTerminalsQuery} [opts.query] - Query params (providerId)
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */
@@ -128,12 +131,13 @@ function prismaTerminalsFactory(_ref) {
     },
 
     /**
-     * POST /prisma-terminals/payments/:id/refunds - create refund. API does not accept query params.
+     * POST /prisma-terminals/payments/:id/refunds - create refund.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.id - Payment id
+     * @param {string} opts.id - Payment id (prismaPaymentId)
      * @param {Object} opts.prismaRefund - Prisma refund payload
+     * @param {PrismaTerminalsQuery} [opts.query] - Query params (providerId)
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */
@@ -156,11 +160,12 @@ function prismaTerminalsFactory(_ref) {
     },
 
     /**
-     * DELETE /prisma-terminals/refunds/:id - delete refund. API does not accept query params.
+     * DELETE /prisma-terminals/refunds/:id - delete refund.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.id - Refund id
+     * @param {string} opts.id - Refund id (prismaPaymentId)
+     * @param {PrismaTerminalsQuery} [opts.query] - Query params (providerId)
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */
@@ -236,11 +241,12 @@ function prismaTerminalsFactory(_ref) {
     },
 
     /**
-     * POST /prisma-terminals/payments - create payment. API does not accept query params.
+     * POST /prisma-terminals/payments - create payment.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {Object} opts.prismaPayment - Prisma payment payload
+     * @param {PrismaTerminalsQuery} [opts.query] - Query params (providerId)
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */
@@ -262,11 +268,12 @@ function prismaTerminalsFactory(_ref) {
     },
 
     /**
-     * DELETE /prisma-terminals/payments/:id - delete payment. API does not accept query params.
+     * DELETE /prisma-terminals/payments/:id - delete payment.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.id - Payment id
+     * @param {string} opts.id - Payment id (prismaPaymentId)
+     * @param {PrismaTerminalsQuery} [opts.query] - Query params (providerId)
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */
@@ -287,12 +294,13 @@ function prismaTerminalsFactory(_ref) {
     },
 
     /**
-     * PUT /prisma-terminals/payments/:id - update payment. API does not accept query params.
+     * PUT /prisma-terminals/payments/:id - update payment (hidden in API docs).
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.id - Payment id
+     * @param {string} opts.id - Payment id (prismaPaymentId)
      * @param {Object} opts.prismaPayment - Prisma payment payload
+     * @param {PrismaTerminalsQuery} [opts.query] - Query params (providerId, validatePayment)
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */
@@ -320,11 +328,12 @@ function prismaTerminalsFactory(_ref) {
 
   var settlements = {
     /**
-     * POST /prisma-terminals/settlements - create settlement. API does not accept query params.
+     * POST /prisma-terminals/settlements - create settlement.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {Object} opts.settlement - Settlement payload
+     * @param {PrismaTerminalsQuery} [opts.query] - Query params (providerId)
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */

package/lib/endpoints/btrzpay/referenced-payments.js

@@ -23,14 +23,14 @@ function referencedPaymentsFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /referenced-payments/:transactionId/:referenceNumber/status - get status. API does not accept query params.
+   * GET /referenced-payments/:transactionId/:referenceNumber/status - get referenced payment status. Requires backoffice auth. Response body: { paymentResult: { status, result } | null }.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.transactionId - Transaction id
-   * @param {string} opts.referenceNumber - Reference number
+   * @param {string} opts.transactionId - Transaction ID
+   * @param {string} opts.referenceNumber - Reference number of the payment
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ paymentResult: { status: "error"|"pending"|"success"|"review", result: object } | null }>>}
    */
   function getStatus(_ref2) {
     var token = _ref2.token,

package/lib/endpoints/btrzpay/square.js

@@ -4,7 +4,7 @@ var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
 /**
- * Factory for Square webhooks API (btrz-api-payments).
+ * Factory for Square webhooks API (btrz-api-payments). Used to forward or simulate Square webhook requests to the Payments API.
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
@@ -17,14 +17,14 @@ function squareWebhooksFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * POST /square-webhooks/:providerId - create Square webhook. API does not accept query params.
+   * POST /square-webhooks/:providerId - send Square webhook payload to the Payments API. API verifies x-square-signature when present. Body must include type and data (Square webhook format).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.providerId - Provider id
-   * @param {Object} opts.data - Request body
-   * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @param {string} opts.providerId - Provider ID (square_terminal payment method owner)
+   * @param {Object} opts.data - Request body (Square webhook payload: type, data required; optional merchant_id, event_id, created_at)
+   * @param {Object} [opts.headers] - Optional headers (e.g. x-square-signature for verification)
+   * @returns {Promise<import("axios").AxiosResponse<{ status: "OK" }>>}
    */
   function create(_ref2) {
     var token = _ref2.token,
@@ -58,12 +58,12 @@ function squareTerminalsFactory(_ref3) {
       internalAuthTokenProvider = _ref3.internalAuthTokenProvider;
 
   /**
-   * GET /square-terminals - get Square terminals. API does not accept query params.
+   * GET /square-terminals - list Square terminals for the account. Requires JWT (BETTEREZ_APP or MOBILE_SCANNER). Response body: { terminals } with terminal objects (id, name, code, deviceId, productType, locationId, status, pairBy, createdAt, statusChangedAt).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ terminals: Array<{ id: string, name: string, code: string, deviceId?: string, productType?: string, locationId: string, status?: string, pairBy?: string, createdAt?: string, statusChangedAt?: string }> }>>}
    */
   function get(_ref4) {
     var token = _ref4.token,

package/lib/endpoints/btrzpay/stripe-terminals.js

@@ -6,7 +6,15 @@ var _require = require("./../endpoints_helpers.js"),
 /**
  * Query params for GET /stripe-terminals (btrz-api-payments). See get-handler getSpec().
  * @typedef {Object} StripeTerminalsListQuery
- * @property {string} [providerId] - Account provider (operator) ID; used by agencies/sellers
+ * @property {string} [providerId] - Account provider (operator) ID; used by agencies/sellers; when omitted, authenticated account ID is used
+ */
+
+/**
+ * Response for GET /stripe-terminals. Paginated list of Stripe readers.
+ * @typedef {Object} GetStripeTerminalsResponse
+ * @property {Object[]} stripeTerminals - Stripe Terminal reader objects (id, label, serial_number, status, etc.)
+ * @property {string} next - Next page link; empty if no next page
+ * @property {string} previous - Previous page link; empty if no previous page
  */
 
 /**
@@ -23,13 +31,13 @@ function stripeTerminalsFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /stripe-terminals - list Stripe terminals.
+   * GET /stripe-terminals - list Stripe Terminal readers for the account (paginated).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {StripeTerminalsListQuery} [opts.query] - Query params (providerId)
+   * @param {StripeTerminalsListQuery} [opts.query] - Optional providerId
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<GetStripeTerminalsResponse>>} Rejects with 400 (STRIPE_SECRET_KEY_INVALID), 401, 404 (PAYMENT_METHOD_NOT_FOUND), 500.
    */
   function all(_ref2) {
     var token = _ref2.token,
@@ -47,29 +55,26 @@ function stripeTerminalsFactory(_ref) {
   }
 
   /**
-   * POST /stripe-terminals/:id/simulate - simulate Stripe payment. API does not accept query params.
+   * POST /stripe-terminals/:terminalId/simulate - simulate a payment on a Stripe Terminal reader. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.id - Terminal id
-   * @param {Object} opts.stripePayment - Stripe payment payload
+   * @param {string} opts.id - Terminal ID (Stripe reader id, e.g. tmr_xxx)
+   * @param {{ ccNumber: string }} opts.stripePayment - Payment to simulate; ccNumber required
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ stripeTerminalPayment: Object }>>} Rejects with 400 (WRONG_DATA), 401, 404 (PAYMENT_METHOD_NOT_FOUND, TRANSACTION_NOT_FOUND), 409 (errorCode/errorMessage), 500.
    */
   function simulate(_ref3) {
     var token = _ref3.token,
         jwtToken = _ref3.jwtToken,
         id = _ref3.id,
         stripePayment = _ref3.stripePayment,
-        _ref3$query = _ref3.query,
-        query = _ref3$query === undefined ? {} : _ref3$query,
         headers = _ref3.headers;
 
     return client({
       url: "/stripe-terminals/" + id + "/simulate",
       method: "post",
       headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers }),
-      params: query,
       data: { stripePayment: stripePayment }
     });
   }

package/lib/endpoints/btrzpay/stripe3ds.js

@@ -0,0 +1,54 @@
+"use strict";
+
+/* eslint-disable max-len */
+var _require = require("../endpoints_helpers.js"),
+    authorizationHeaders = _require.authorizationHeaders;
+
+/**
+ * Request body for POST /stripe-payment-intent (btrz-api-payments). PaymentIntentPostData.
+ * @typedef {Object} PaymentIntentPostData
+ * @property {string} providerName - Provider name (e.g. "stripe") used to resolve the payment method with Stripe 3DS
+ * @property {Object} data - Payment data: card details, amount, currency, transactionId, customer info, etc.
+ */
+
+/**
+ * Factory for Stripe 3DS API (btrz-api-payments): create Stripe Payment Intent for 3DS flows.
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ createPaymentIntent: function }}
+ */
+
+
+function stripe3dsFactory(_ref) {
+  var client = _ref.client,
+      internalAuthTokenProvider = _ref.internalAuthTokenProvider;
+
+  /**
+   * POST /stripe-payment-intent - creates a Stripe Payment Intent for 3DS; returns requires_action and payment_intent_client_secret.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} opts.providerName - Provider name (e.g. "stripe")
+   * @param {Object} opts.data - Payment data (card, amount, currency, transactionId, etc.)
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<{ requires_action: boolean, payment_intent_client_secret: string }>>} PaymentIntentResponse. Rejects with 400 (WRONG_DATA, PAYMENT_INTENT_MISSING_PAYMENT_DATA, PAYMENT_INTENT_MISSING_PROVIDER, PROVIDER_NOT_FOUND, MISSING_PAYMENT_METHOD_PARAMS, PAYMENT_METHOD_NOT_FOUND, STRIPE_MISSING_PRIVATE_KEY, MISSING_PAYMENT_DATA), 401, 500.
+   */
+  function createPaymentIntent(_ref2) {
+    var token = _ref2.token,
+        jwtToken = _ref2.jwtToken,
+        providerName = _ref2.providerName,
+        data = _ref2.data,
+        headers = _ref2.headers;
+
+    return client.post("/stripe-payment-intent", { providerName: providerName, data: data }, {
+      headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
+    });
+  }
+
+  return {
+    createPaymentIntent: createPaymentIntent
+  };
+}
+
+module.exports = stripe3dsFactory;

package/lib/endpoints/btrzpay/terminalPayments.js

@@ -6,10 +6,10 @@ var _require = require("../endpoints_helpers.js"),
 /**
  * Query params for GET /terminal-payments/mit/:id (btrz-api-payments). See get-mit-by-id-handler getSpec().
  * @typedef {Object} TerminalPaymentsMitGetQuery
- * @property {string} [providerId] - Account provider (operator) ID; used by agencies/sellers
- * @property {string} [branchId] - Branch id where payment started (required for GET)
- * @property {string} [companyId] - Company id where payment started (required for GET)
- * @property {string} [date] - Date when payment started; format dd/mm/yyyy (required for GET)
+ * @property {string} [providerId] - Account provider (operator) ID; used by agencies/sellers; when omitted, authenticated account is used
+ * @property {string} branchId - Branch id where payment started (required). Example: 00676
+ * @property {string} companyId - Company id where payment started (required). Example: Z890
+ * @property {string} date - Date when payment started; format dd/mm/yyyy (required)
  */
 
 /**
@@ -33,15 +33,15 @@ function terminalPaymentsFactory(_ref) {
 
   var mit = {
     /**
-     * PUT /terminal-payments/mit/:id - update MIT terminal payment.
+     * PUT /terminal-payments/mit/:terminalPaymentId - complete MIT terminal payment with result from terminal.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.id - Terminal payment id
-     * @param {Object} opts.terminalPayment - Terminal payment payload
-     * @param {TerminalPaymentsMitPutQuery} [opts.query] - Query params (providerId)
+     * @param {string} opts.id - Terminal payment ID (UUID)
+     * @param {{ result?: Object, paymentRequest: Object, orderId: string }} opts.terminalPayment - Terminal payment data (result, paymentRequest, orderId)
+     * @param {TerminalPaymentsMitPutQuery} [opts.query] - Optional providerId
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse<{ terminalPayment: Object }>>} Rejects with 400 (WRONG_DATA, INVALID_TERMINALPAYMENT_ID, INVALID_RESULT_OBJECT, MIT_*), 401, 404 (TERMINALPAYMENT_NOT_FOUND, MIT_PAYMENT_NOT_FOUND), 409 (CANT_UPDATE_ORDER), 500.
      */
     update: function update(_ref2) {
       var token = _ref2.token,
@@ -62,14 +62,14 @@ function terminalPaymentsFactory(_ref) {
     },
 
     /**
-     * GET /terminal-payments/mit/:id - get MIT terminal payment.
+     * GET /terminal-payments/mit/:terminalPaymentId - get MIT terminal payment result from MIT servers.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.id - Terminal payment id
-     * @param {TerminalPaymentsMitGetQuery} [opts.query] - Query params (providerId, branchId, companyId, date)
+     * @param {string} opts.id - Terminal payment ID (UUID)
+     * @param {TerminalPaymentsMitGetQuery} opts.query - branchId, companyId, date (required); optional providerId
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse<{ terminalPayment: Object }>>} Rejects with 400 (WRONG_DATA, INVALID_TERMINALPAYMENT_ID, INVALID_DATE, MIT_*), 401, 404 (TERMINALPAYMENT_NOT_FOUND, MIT_PAYMENT_NOT_FOUND), 500.
      */
     get: function get(_ref3) {
       var token = _ref3.token,
@@ -88,14 +88,14 @@ function terminalPaymentsFactory(_ref) {
 
   var webhooks = {
     /**
-     * POST /terminal-payments/webhooks/getnet/:providerId - Getnet webhook. API does not accept query params.
+     * POST /terminal-payments/webhooks/getnet/:providerId - Getnet Terminal webhook (inbound). API does not accept query params.
      * @param {Object} opts
-     * @param {Object} opts.data - Request body
-     * @param {string} opts.providerId - Provider id
+     * @param {Object} opts.data - Getnet webhook payload (e.g. TrxResult, TrxReference, userId)
+     * @param {string} opts.providerId - Provider (account) ID for getnet_terminal payment method
      * @param {Object} [opts.headers] - Optional headers
-     * @param {string} [opts.token] - API key
-     * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @param {string} [opts.token] - API key (optional when no userId in payload)
+     * @param {string} [opts.jwtToken] - JWT or internal auth (required when userId is in payload)
+     * @returns {Promise<import("axios").AxiosResponse<{ status: string }>>} Rejects with 400 (INVALID_WEBHOOK_PAYLOAD), 401 (when userId present but not authenticated), 404 (PAYMENT_NOT_FOUND_FOR_WEBHOOK_EVENT, PAYMENT_METHOD_NOT_FOUND, USER_NOT_FOUND), 409 (CANT_UPDATE_ORDER), 500.
      */
     getnet: function getnet(_ref4) {
       var data = _ref4.data,

package/lib/endpoints/coltrane/healthcheck.js

@@ -0,0 +1,35 @@
+"use strict";
+
+/**
+ * Factory for Coltrane healthcheck API (btrz-api-coltrane) — liveness probe.
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @returns {{ get: function }}
+ */
+function healthcheckFactory(_ref) {
+  var client = _ref.client;
+
+  /**
+   * GET /healthcheck — liveness probe. Returns 200 with empty body when the service is running. No authentication required.
+   * @param {Object} [opts]
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<{ data: {} }>>}
+   * @throws {import("axios").AxiosError} 500 Service unhealthy or shutting down
+   */
+  function get() {
+    var _ref2 = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
+        headers = _ref2.headers;
+
+    return client({
+      url: "/healthcheck",
+      method: "get",
+      headers: headers || {}
+    });
+  }
+
+  return {
+    get: get
+  };
+}
+
+module.exports = healthcheckFactory;

package/lib/endpoints/coltrane/info.js

@@ -0,0 +1,35 @@
+"use strict";
+
+/* eslint-disable max-len */
+/**
+ * Factory for Coltrane info API (btrz-api-coltrane) — service and dependency status.
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @returns {{ get: function }}
+ */
+function infoFactory(_ref) {
+  var client = _ref.client;
+
+  /**
+   * GET /info — get Coltrane API service status and dependency health. No authentication required.
+   * @param {Object} [opts]
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<{ data: { status: number, services: Array<{ name: string, status: number }>, build?: string, instanceId?: string, commit?: string } }>>}
+   * @throws {import("axios").AxiosError} 500 Internal server error or dependency check failure
+   */
+  function get() {
+    var _ref2 = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
+        headers = _ref2.headers;
+
+    return client({
+      url: "/info",
+      headers: headers || {}
+    });
+  }
+
+  return {
+    get: get
+  };
+}
+
+module.exports = infoFactory;