@mitumba/sdk 1.27.1 → 1.29.0

package/dist/index.mjs

@@ -723,12 +723,36 @@ var PayModule = class {
   async initPaystack(input, options) {
     return this.client.post("/pay/paystack/init", input, options);
   }
+  /**
+   * Initiate a provider-neutral checkout for an order.
+   *
+   * The payment provider is selected by the API. Continue checkout using the
+   * returned next action, then poll {@link getCheckoutStatus} for payment state.
+   * Retrying after cancellation requires the same input and idempotency key.
+   *
+   * @param input - Order, idempotency key, and buyer-selected payment method.
+   * @param options - Request options, including an optional abort signal.
+   * @returns The initiated attempt and its required continuation action.
+   * @throws {APIError} When the API rejects or cannot initiate the checkout.
+   */
+  async initiateCheckout(input, options) {
+    return this.client.post("/pay/checkout/initiate", input, options);
+  }
   /**
    * Poll for the current status of a payment by its order ID.
+   *
+   * @deprecated Use {@link getCheckoutStatus} for the typed checkout lifecycle.
+   * This method retains its legacy route and response for compatibility.
    */
   async getStatus(orderId, options) {
     return this.client.get(`/pay/status/${orderId}`, void 0, options);
   }
+  /**
+   * Get the buyer-visible checkout lifecycle for a retail or bale order.
+   */
+  async getCheckoutStatus(orderId, options) {
+    return this.client.get(`/pay/checkout-status/${orderId}`, void 0, options);
+  }
 };
 
 // src/modules/vazi.ts