btrz-api-client 8.33.0 → 8.35.0

package/src/endpoints/btrzpay/adyen.js

@@ -0,0 +1,44 @@
+/* eslint-disable max-len */
+/* eslint-disable import/extensions */
+const {authorizationHeaders} = require("../endpoints_helpers.js");
+
+/**
+ * Query params for GET /adyen-payment-methods (btrz-api-payments). See getAdyenPaymentMethods getSpec().
+ * @typedef {Object} AdyenPaymentMethodsQuery
+ * @property {string} [countryCode] - Two-letter ISO country code to filter allowed payment methods
+ * @property {string} [currencyCode] - Three-letter ISO currency code to filter allowed payment methods
+ * @property {number} [amount] - Amount used to determine allowed payment methods
+ * @property {string} [transactionId] - Transaction identifier for the payment session
+ */
+
+/**
+ * Factory for Adyen API (btrz-api-payments).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ getPaymentMethods: function }}
+ */
+function adyenFactory({client, internalAuthTokenProvider}) {
+  /**
+   * GET /adyen-payment-methods - returns allowed Adyen payment methods for the account.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {AdyenPaymentMethodsQuery} [opts.query] - Query params (countryCode, currencyCode, amount, transactionId)
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<{ AdyenPaymentMethods: Array<{ name: string, type: string, brands?: string[] }> }>>}
+   *   Resolves with GetAdyenPaymentMethodsResponse. Rejects with 400 (INVALID_*), 404 (ADYEN_PAYMENT_METHODS_NOT_FOUND, PROVIDER_NOT_FOUND, PAYMENT_METHOD_NOT_FOUND).
+   */
+  function getPaymentMethods({token, jwtToken, query = {}, headers}) {
+    return client.get("/adyen-payment-methods", {
+      params: query,
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+    });
+  }
+
+  return {
+    getPaymentMethods
+  };
+}
+
+module.exports = adyenFactory;

package/src/endpoints/btrzpay/cardpointe.js

@@ -51,7 +51,7 @@ function cardpointeTerminalsFactory({client, internalAuthTokenProvider}) {
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.readCardResultId - Read card result id
+     * @param {string} opts.readCardResultId - Read card result id (UUID v4)
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */
@@ -62,19 +62,21 @@ function cardpointeTerminalsFactory({client, internalAuthTokenProvider}) {
       });
     },
     /**
-     * POST /cardpointe-terminals/read-card - create read card. API does not accept query params.
+     * POST /cardpointe-terminals/read-card - start read card session. API accepts optional query providerId.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {Object} opts.readCard - Read card payload
+     * @param {Object} opts.readCard - Read card payload (merchantId, terminalId, amount)
+     * @param {string} [opts.providerId] - Provider (payment method) ID; if omitted, account ID is used
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */
     // eslint-disable-next-line no-shadow
-    create({token, jwtToken, readCard, headers}) {
+    create({token, jwtToken, readCard, providerId, headers}) {
       return client({
         url: "/cardpointe-terminals/read-card",
         method: "post",
+        params: providerId != null ? {providerId} : {},
         headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
         data: {readCard}
       });

package/src/endpoints/btrzpay/customerCards.js

@@ -9,15 +9,15 @@ const {authorizationHeaders} = require("../endpoints_helpers.js");
  */
 function customerCardsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /payment-methods/:paymentMethodId/customers/:customerId/cards/:customerCardId - get card. API does not accept query params.
+   * GET .../cards/:customerCardId - get one card by id. No query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.paymentMethodId - Payment method id
-   * @param {string} opts.customerId - Customer id
-   * @param {string} opts.customerCardId - Customer card id
+   * @param {string} opts.paymentMethodId - Payment method ID (UUID v4)
+   * @param {string} opts.customerId - Customer ID (object ID)
+   * @param {string} opts.customerCardId - Card ID (UUID v4)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customerCard: Object }>>}
    */
   function get({token, jwtToken, paymentMethodId, customerId, customerCardId, headers}) {
     return client.get(`/payment-methods/${paymentMethodId}/customers/${customerId}/cards/${customerCardId}`, {
@@ -27,14 +27,14 @@ function customerCardsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * GET /payment-methods/:paymentMethodId/customers/:customerId/cards - list cards. API does not accept query params.
+   * GET .../cards - list all cards for customer. No query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.paymentMethodId - Payment method id
-   * @param {string} opts.customerId - Customer id
+   * @param {string} opts.paymentMethodId - Payment method ID (UUID v4)
+   * @param {string} opts.customerId - Customer ID (object ID)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customerCards: Array<Object> }>>}
    */
   function all({token, jwtToken, paymentMethodId, customerId, headers}) {
     return client.get(`/payment-methods/${paymentMethodId}/customers/${customerId}/cards`, {
@@ -44,15 +44,15 @@ function customerCardsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /payment-methods/:paymentMethodId/customers/:customerId/cards - create card. API does not accept query params.
+   * POST .../cards - create stored card. Body: { customerCard }. No query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.paymentMethodId - Payment method id
-   * @param {string} opts.customerId - Customer id
-   * @param {Object} opts.customerCard - Customer card payload
+   * @param {string} opts.paymentMethodId - Payment method ID (UUID v4)
+   * @param {string} opts.customerId - Customer ID (object ID)
+   * @param {Object} opts.customerCard - Card payload (see PostCustomerCardRequest)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customerCard: Object }>>}
    */
   function create({token, jwtToken, paymentMethodId, customerId, customerCard, headers}) {
     return client({
@@ -64,15 +64,15 @@ function customerCardsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /payment-methods/:paymentMethodId/customers/:customerId/cards/:customerCardId - remove card. API does not accept query params.
+   * DELETE .../cards/:customerCardId - remove stored card. No query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.paymentMethodId - Payment method id
-   * @param {string} opts.customerId - Customer id
-   * @param {string} opts.customerCardId - Customer card id
+   * @param {string} opts.paymentMethodId - Payment method ID (UUID v4)
+   * @param {string} opts.customerId - Customer ID (object ID)
+   * @param {string} opts.customerCardId - Card ID (UUID v4)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ success: boolean }>>}
    */
   function remove({token, jwtToken, paymentMethodId, customerId, customerCardId, headers}) {
     return client({

package/src/endpoints/btrzpay/customers.js

@@ -1,7 +1,7 @@
 const {authorizationHeaders} = require("../endpoints_helpers.js");
 
 /**
- * Factory for payment-method customers API (btrz-api-payments).
+ * Factory for payment-method customers API (btrz-api-payments). Path: payment-methods/{id}/customers.
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
@@ -9,14 +9,14 @@ const {authorizationHeaders} = require("../endpoints_helpers.js");
  */
 function customersFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /payment-methods/:paymentMethodId/customers/:customerId - get customer. API does not accept query params.
+   * GET .../customers/:customerId - get customer. No query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.paymentMethodId - Payment method id
-   * @param {string} opts.customerId - Customer id
+   * @param {string} opts.paymentMethodId - Payment method ID (UUID v4)
+   * @param {string} opts.customerId - Customer ID (object ID)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customer: Object }>>}
    */
   function get({token, jwtToken, paymentMethodId, customerId, headers}) {
     return client.get(`/payment-methods/${paymentMethodId}/customers/${customerId}`, {
@@ -26,14 +26,14 @@ function customersFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /payment-methods/:paymentMethodId/customers - create customer. API does not accept query params.
+   * POST .../customers - create customer. Body: { customer } (PostCustomerRequest: channel, customer.id/number/email). No query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.paymentMethodId - Payment method id
-   * @param {Object} opts.customer - Customer payload
+   * @param {string} opts.paymentMethodId - Payment method ID (UUID v4)
+   * @param {Object} opts.customer - PostCustomerRequest (channel, customer with id, number, email)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customer: Object }>>}
    */
   function create({token, jwtToken, paymentMethodId, customer, headers}) {
     return client({
@@ -45,14 +45,14 @@ function customersFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /payment-methods/:paymentMethodId/customers/:customerId - remove customer. API does not accept query params.
+   * DELETE .../customers/:customerId - remove customer (and saved cards). No query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.paymentMethodId - Payment method id
-   * @param {string} opts.customerId - Customer id
+   * @param {string} opts.paymentMethodId - Payment method ID (UUID v4)
+   * @param {string} opts.customerId - Customer ID (object ID)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ success: boolean }>>}
    */
   function remove({token, jwtToken, paymentMethodId, customerId, headers}) {
     return client({

package/src/endpoints/btrzpay/cybersource3ds.js

@@ -0,0 +1,114 @@
+/* eslint-disable max-len */
+const {authorizationHeaders} = require("../endpoints_helpers.js");
+
+/**
+ * Query params for GET /cbs-token (btrz-api-payments). See getSpec() in get-token-handler.
+ * @typedef {Object} Cybersource3dsTokenQuery
+ * @property {string} transactionId - Transaction ID for which to create the 3DS token (required). ObjectId format.
+ * @property {string} [operatingCompanyId] - Operating company ID when Cybersource uses overrides by operating company. ObjectId format.
+ */
+
+/**
+ * Request body for POST /cbs-evaluate-risk. RiskEvaluationPostData.
+ * @typedef {Object} RiskEvaluationPostData
+ * @property {Object} paymentData - Payment information (required)
+ * @property {Object} [cartPayload] - Cart information (CartData)
+ * @property {string} [operatingCompanyId] - Operating company ID
+ * @property {string} [providerName] - Provider name (e.g. "cybersource")
+ */
+
+/**
+ * Request body for POST /cbs-pa-enrollment. PayerAuthenticationPostData.
+ * @typedef {Object} PayerAuthenticationPostData
+ * @property {Object} paymentData - Payment information (required)
+ * @property {string} [operatingCompanyId] - Operating company ID
+ * @property {string} [providerName] - Provider name (e.g. "cybersource")
+ */
+
+/**
+ * Request body for POST /cbs-validate-pa-enrollment. ValidateAuthenticationPostData.
+ * @typedef {Object} ValidateAuthenticationPostData
+ * @property {Object} paymentData - Payment information (required)
+ * @property {string} processorTransactionId - Processor transaction ID from payer authentication enrollment (required)
+ * @property {string} [operatingCompanyId] - Operating company ID
+ * @property {string} [providerName] - Provider name (e.g. "cybersource")
+ */
+
+/**
+ * Factory for Cybersource 3DS API (btrz-api-payments): Cardinal/Cybersource token, evaluate risk, payer auth enrollment, validate enrollment.
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ getToken: function, evaluateRisk: function, payerAuthenticationEnrollment: function, validatePayerAuthenticationEnrollment: function }}
+ */
+function cybersource3dsFactory({client, internalAuthTokenProvider}) {
+  /**
+   * GET /cbs-token - returns JWT to use with Cardinal (3DS).
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {Cybersource3dsTokenQuery} opts.query - transactionId (required), optional operatingCompanyId
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<{ token: string }>>} ThreeDSTokenResponse. Rejects with 400 (WRONG_DATA, INVALID_TRANSACTION_ID, PROVIDER_NOT_FOUND, PAYMENT_METHOD_NOT_FOUND), 401, 500.
+   */
+  function getToken({token, jwtToken, query, headers}) {
+    return client.get("/cbs-token", {
+      params: query,
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+    });
+  }
+
+  /**
+   * POST /cbs-evaluate-risk - evaluate fraud risk (Decision Manager).
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {RiskEvaluationPostData} opts.riskEvaluation - paymentData (required), optional cartPayload, operatingCompanyId
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<RiskEvaluationResponse>>} RiskEvaluationResponse. Rejects with 400 (EVAL_RISK_*), 401, 409 (CYBERSOURCE_AUTH_FAILED), 500.
+   */
+  function evaluateRisk({token, jwtToken, riskEvaluation, headers}) {
+    return client.post("/cbs-evaluate-risk", riskEvaluation, {
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+    });
+  }
+
+  /**
+   * POST /cbs-pa-enrollment - check payer authentication enrollment.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {PayerAuthenticationPostData} opts.body - paymentData (required), optional operatingCompanyId
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<PAEnrollmentResponse>>} PAEnrollmentResponse. Rejects with 400 (PAENROLL_*, PROVIDER_NOT_FOUND, PAYMENT_METHOD_NOT_FOUND), 401, 500.
+   */
+  function payerAuthenticationEnrollment({token, jwtToken, body, headers}) {
+    return client.post("/cbs-pa-enrollment", body, {
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+    });
+  }
+
+  /**
+   * POST /cbs-validate-pa-enrollment - validate payer authentication challenge response.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {ValidateAuthenticationPostData} opts.body - paymentData and processorTransactionId (required)
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<ValidatePAEnrollmentResponse>>} ValidatePAEnrollmentResponse. Rejects with 400 (VALIDATE_PAENROLL_*), 401, 500.
+   */
+  function validatePayerAuthenticationEnrollment({token, jwtToken, body, headers}) {
+    return client.post("/cbs-validate-pa-enrollment", body, {
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+    });
+  }
+
+  return {
+    getToken,
+    evaluateRisk,
+    payerAuthenticationEnrollment,
+    validatePayerAuthenticationEnrollment
+  };
+}
+
+module.exports = cybersource3dsFactory;

package/src/endpoints/btrzpay/datalogic.js

@@ -5,104 +5,139 @@ const {
 /**
  * Query params for GET /datalogic/payments (btrz-api-payments). See get-payments-handler getSpec().
  * @typedef {Object} DatalogicPaymentsListQuery
- * @property {string} [referenceNumber] - The payment reference number
+ * @property {string} referenceNumber - Payment reference number (required)
  */
 
 /**
- * Factory for Datalogic API (btrz-api-payments).
+ * Request body for POST /datalogic/payments/:referenceNumber. PostDatalogicPaymentsPayload.
+ * @typedef {Object} PostDatalogicPaymentsPayload
+ * @property {string} folio - FEMSA transaction id
+ * @property {number} id_terminal - Terminal/group ID
+ * @property {string} local_date - Local date (e.g. "02/08/2022 20:33:43")
+ * @property {string} amount - Debt amount
+ * @property {number} trx_no - Transaction number
+ */
+
+/**
+ * Request body for POST /datalogic/reverse/:referenceNumber. PostDatalogicReversePayload.
+ * @typedef {Object} PostDatalogicReversePayload
+ * @property {string} folio - FEMSA transaction id
+ * @property {number} id_terminal - Terminal/group ID
+ * @property {string} local_date - Local date (e.g. "02/08/2022 20:33:43")
+ * @property {number} trx_no - Transaction number
+ */
+
+/**
+ * Factory for Datalogic 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]
  * @returns {{ payments: Object, referenceNumber: Object, authCode: Object }}
  */
-function datalogicFactory({client}) {
+function datalogicFactory({client, internalAuthTokenProvider}) {
+  function authProvider(opts) {
+    return opts !== undefined && opts !== null ? opts : internalAuthTokenProvider;
+  }
+
   const payments = {
     /**
-     * GET /datalogic/payments - list Datalogic payments.
+     * GET /datalogic/payments - list Datalogic payments by reference number.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {DatalogicPaymentsListQuery} [opts.query] - Query params (referenceNumber)
+     * @param {DatalogicPaymentsListQuery} opts.query - referenceNumber (required)
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @param {{ getToken: function(): string }} [opts.internalAuthTokenProvider] - Internal auth provider
+     * @returns {Promise<import("axios").AxiosResponse<{ payments: Array }>>}
+     *   GetDatalogicPaymentsResponse. Rejects 400, 401, 500.
      */
-    all({token, jwtToken, headers, query, internalAuthTokenProvider}) {
+    all({token, jwtToken, headers, query, internalAuthTokenProvider: optsAuth}) {
       return client({
         url: "/datalogic/payments",
         params: query,
-        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider: authProvider(optsAuth), headers})
       });
     },
     /**
-     * POST /datalogic/payments/:referenceNumber - update Datalogic payment. API does not accept query params.
+     * POST /datalogic/payments/:referenceNumber - pay by reference (20 digits).
+     * Body: datalogicInfo or flat PostDatalogicPaymentsPayload.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.referenceNumber - Reference number
-     * @param {Object} [opts.data] - Request body
+     * @param {string} opts.referenceNumber - Reference number (20 digits)
+     * @param {PostDatalogicPaymentsPayload|{ datalogicInfo: PostDatalogicPaymentsPayload }} opts.data - Body
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @param {{ getToken: function(): string }} [opts.internalAuthTokenProvider] - Internal auth provider
+     * @returns {Promise<import("axios").AxiosResponse<{ payment: Object }>>}
+     *   PostDatalogicPaymentsResponse. Rejects 400, 401, 500.
      */
-    update({token, jwtToken, headers, query, referenceNumber, data, internalAuthTokenProvider}) {
+    update({token, jwtToken, headers, query, referenceNumber, data, internalAuthTokenProvider: optsAuth}) {
       return client({
         url: `/datalogic/payments/${referenceNumber}`,
         method: "post",
         params: query,
         data,
-        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider: authProvider(optsAuth), headers})
       });
     },
     /**
-     * POST /datalogic/reverse/:referenceNumber - reverse Datalogic payment. API does not accept query params.
+     * POST /datalogic/reverse/:referenceNumber - reverse by reference (20 digits).
+     * Body: datalogicReverseInfo or flat PostDatalogicReversePayload.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.referenceNumber - Reference number
-     * @param {Object} [opts.data] - Request body
+     * @param {string} opts.referenceNumber - Reference number (20 digits)
+     * @param {PostDatalogicReversePayload|{ datalogicReverseInfo: PostDatalogicReversePayload }} opts.data - Body
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @param {{ getToken: function(): string }} [opts.internalAuthTokenProvider] - Internal auth provider
+     * @returns {Promise<import("axios").AxiosResponse<{ payment: Object }>>}
+     *   PostDatalogicPaymentsResponse. Rejects 400, 401, 500.
      */
-    reverse({token, jwtToken, headers, query, referenceNumber, data, internalAuthTokenProvider}) {
+    reverse({token, jwtToken, headers, query, referenceNumber, data, internalAuthTokenProvider: optsAuth}) {
       return client({
         url: `/datalogic/reverse/${referenceNumber}`,
         method: "post",
         params: query,
         data,
-        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider: authProvider(optsAuth), headers})
       });
     }
   };
 
   const referenceNumber = {
     /**
-     * GET /datalogic/reference-number - get reference number. API does not accept query params.
+     * GET /datalogic/reference-number - get new Datalogic reference number.
      * @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>}
+     * @param {{ getToken: function(): string }} [opts.internalAuthTokenProvider] - Internal auth provider
+     * @returns {Promise<import("axios").AxiosResponse<{ referenceNumber: string }>>}
+     *   GetDatalogicReferenceNumberResponse. Rejects 401, 404, 500.
      */
-    get({token, jwtToken, headers, internalAuthTokenProvider}) {
+    get({token, jwtToken, headers, internalAuthTokenProvider: optsAuth}) {
       return client({
         url: "/datalogic/reference-number",
-        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider: authProvider(optsAuth), headers})
       });
     }
   };
 
   const authCode = {
     /**
-     * GET /datalogic/auth-code - get auth code. API does not accept query params.
+     * GET /datalogic/auth-code - get new Datalogic authorization code.
      * @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>}
+     * @param {{ getToken: function(): string }} [opts.internalAuthTokenProvider] - Internal auth provider
+     * @returns {Promise<import("axios").AxiosResponse<{ authCode: string }>>}
+     *   GetDatalogicAuthCodeResponse. Rejects 401, 404, 500.
      */
-    get({token, jwtToken, headers, internalAuthTokenProvider}) {
+    get({token, jwtToken, headers, internalAuthTokenProvider: optsAuth}) {
       return client({
         url: "/datalogic/auth-code",
-        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider: authProvider(optsAuth), headers})
       });
     }
   };