@paykit-sdk/monnify 1.3.0 → 1.3.1

package/dist/index.js

@@ -211,6 +211,48 @@ var MonnifyProvider = class extends core.AbstractPayKitProvider {
     }
     return altResponse.value.responseBody;
   }
+  /**
+   * Monnify only has one way to move money: a hosted redirect
+   * transaction. createCheckout and createPayment both boil down to
+   * this same call - only the input validation and the response
+   * mapper differ between the two.
+   */
+  async initializeTransaction(params) {
+    const paymentReference = crypto.randomUUID();
+    const body = {
+      amount: params.amount,
+      paymentReference,
+      paymentDescription: params.description,
+      currencyCode: params.currency,
+      redirectUrl: params.redirectUrl,
+      paymentMethods: ["CARD", "ACCOUNT_TRANSFER"],
+      metadata: params.metadata,
+      customerEmail: params.email
+    };
+    const response = await this._client.post(
+      "/v1/merchant/transactions/init-transaction",
+      {
+        body: JSON.stringify(body),
+        headers: await this.tokenManager.getAuthHeaders()
+      }
+    );
+    const responseBody = this.ensureResponse(
+      response,
+      "initializeTransaction"
+    );
+    const transactionReference = responseBody.transactionReference;
+    const checkoutUrl = responseBody.checkoutUrl;
+    const transactionResponse = await this._client.get(
+      `/v2/merchant/transactions/query?paymentReference=${paymentReference}`,
+      { headers: await this.tokenManager.getAuthHeaders() }
+    );
+    const transactionData = this.ensureResponse(
+      transactionResponse,
+      "initializeTransaction",
+      "Failed to retrieve transaction details"
+    );
+    return { ...transactionData, checkoutUrl, transactionReference };
+  }
   createCheckout = async (params) => {
     const data = this.validateSchema(
       core.createCheckoutSchema,
@@ -233,50 +275,21 @@ var MonnifyProvider = class extends core.AbstractPayKitProvider {
       data.provider_metadata ?? { currency: "NGN" },
       "The following fields must be present in the provider_metadata of createCheckout: {keys}"
     );
-    const paymentReference = crypto.randomUUID();
-    const body = {
+    const transactionData = await this.initializeTransaction({
+      email: data.customer.email,
       amount,
-      paymentReference,
-      paymentDescription: `Checkout for ${data.item_id} x ${data.quantity} item${data.quantity > 1 ? "s" : ""}`,
-      currencyCode: currency,
+      currency,
       redirectUrl: data.success_url,
-      paymentMethods: ["CARD", "ACCOUNT_TRANSFER"],
+      description: `Checkout for ${data.item_id} x ${data.quantity} item${data.quantity > 1 ? "s" : ""}`,
       metadata: {
         ...params.metadata,
         [core.PAYKIT_METADATA_KEY]: JSON.stringify({
           item: data.item_id,
           qty: data.quantity
         })
-      },
-      customerEmail: data.customer.email
-    };
-    const response = await this._client.post(
-      "/v1/merchant/transactions/init-transaction",
-      {
-        body: JSON.stringify(body),
-        headers: await this.tokenManager.getAuthHeaders()
       }
-    );
-    const responseBody = this.ensureResponse(
-      response,
-      "createCheckout"
-    );
-    const transactionReference = responseBody.transactionReference;
-    const checkoutUrl = responseBody.checkoutUrl;
-    const checkoutResponse = await this._client.get(
-      `/v2/merchant/transactions/query?paymentReference=${paymentReference}`,
-      { headers: await this.tokenManager.getAuthHeaders() }
-    );
-    const checkoutData = this.ensureResponse(
-      checkoutResponse,
-      "createCheckout",
-      "Failed to retrieve checkout details"
-    );
-    return Checkout$inboundSchema({
-      ...checkoutData,
-      checkoutUrl,
-      transactionReference
     });
+    return Checkout$inboundSchema(transactionData);
   };
   retrieveCheckout = async (id) => {
     const transactionData = await this.queryTransaction(
@@ -395,14 +408,39 @@ var MonnifyProvider = class extends core.AbstractPayKitProvider {
     );
   };
   createPayment = async (params) => {
-    throw new core.ProviderNotSupportedError(
-      "createPayment",
-      "Moniepoint",
-      {
-        reason: "Moniepoint doesn't support creating payments",
-        alternative: "Use the createPayment method instead"
-      }
+    const data = this.validateSchema(
+      core.createPaymentSchema,
+      params,
+      "createPayment"
+    );
+    if (!core.isEmailCustomer(data.customer)) {
+      throw new core.InvalidTypeError(
+        "customer",
+        "object (customer) with email",
+        "string (customer ID)",
+        {
+          provider: this.providerName,
+          method: "createPayment"
+        }
+      );
+    }
+    const { success_url } = core.validateRequiredKeys(
+      ["success_url"],
+      data.provider_metadata ?? {},
+      "The following fields must be present in the provider_metadata of createPayment: {keys}"
     );
+    const transactionData = await this.initializeTransaction({
+      email: data.customer.email,
+      amount: data.amount.toString(),
+      currency: data.currency,
+      redirectUrl: success_url,
+      description: `Payment for ${data.item_id}`,
+      metadata: {
+        ...data.metadata,
+        [core.PAYKIT_METADATA_KEY]: JSON.stringify({ item: data.item_id })
+      }
+    });
+    return Payment$inboundSchema(transactionData);
   };
   retrievePayment = async (id) => {
     try {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { schema, Schema, validateRequiredKeys, AbstractPayKitProvider, HTTPClient, OAuth2TokenManager, ValidationError, OperationFailedError, createCheckoutSchema, isEmailCustomer, InvalidTypeError, PAYKIT_METADATA_KEY, ProviderNotSupportedError, createRefundSchema, WebhookError, parseJSON, omitInternalMetadata } from '@paykit-sdk/core';
+import { schema, Schema, validateRequiredKeys, AbstractPayKitProvider, HTTPClient, OAuth2TokenManager, ValidationError, OperationFailedError, createCheckoutSchema, isEmailCustomer, InvalidTypeError, PAYKIT_METADATA_KEY, ProviderNotSupportedError, createPaymentSchema, createRefundSchema, WebhookError, parseJSON, omitInternalMetadata } from '@paykit-sdk/core';
 import { timingSafeEqual } from 'crypto';
 import { sha512 } from 'js-sha512';
 
@@ -209,6 +209,48 @@ var MonnifyProvider = class extends AbstractPayKitProvider {
     }
     return altResponse.value.responseBody;
   }
+  /**
+   * Monnify only has one way to move money: a hosted redirect
+   * transaction. createCheckout and createPayment both boil down to
+   * this same call - only the input validation and the response
+   * mapper differ between the two.
+   */
+  async initializeTransaction(params) {
+    const paymentReference = crypto.randomUUID();
+    const body = {
+      amount: params.amount,
+      paymentReference,
+      paymentDescription: params.description,
+      currencyCode: params.currency,
+      redirectUrl: params.redirectUrl,
+      paymentMethods: ["CARD", "ACCOUNT_TRANSFER"],
+      metadata: params.metadata,
+      customerEmail: params.email
+    };
+    const response = await this._client.post(
+      "/v1/merchant/transactions/init-transaction",
+      {
+        body: JSON.stringify(body),
+        headers: await this.tokenManager.getAuthHeaders()
+      }
+    );
+    const responseBody = this.ensureResponse(
+      response,
+      "initializeTransaction"
+    );
+    const transactionReference = responseBody.transactionReference;
+    const checkoutUrl = responseBody.checkoutUrl;
+    const transactionResponse = await this._client.get(
+      `/v2/merchant/transactions/query?paymentReference=${paymentReference}`,
+      { headers: await this.tokenManager.getAuthHeaders() }
+    );
+    const transactionData = this.ensureResponse(
+      transactionResponse,
+      "initializeTransaction",
+      "Failed to retrieve transaction details"
+    );
+    return { ...transactionData, checkoutUrl, transactionReference };
+  }
   createCheckout = async (params) => {
     const data = this.validateSchema(
       createCheckoutSchema,
@@ -231,50 +273,21 @@ var MonnifyProvider = class extends AbstractPayKitProvider {
       data.provider_metadata ?? { currency: "NGN" },
       "The following fields must be present in the provider_metadata of createCheckout: {keys}"
     );
-    const paymentReference = crypto.randomUUID();
-    const body = {
+    const transactionData = await this.initializeTransaction({
+      email: data.customer.email,
       amount,
-      paymentReference,
-      paymentDescription: `Checkout for ${data.item_id} x ${data.quantity} item${data.quantity > 1 ? "s" : ""}`,
-      currencyCode: currency,
+      currency,
       redirectUrl: data.success_url,
-      paymentMethods: ["CARD", "ACCOUNT_TRANSFER"],
+      description: `Checkout for ${data.item_id} x ${data.quantity} item${data.quantity > 1 ? "s" : ""}`,
       metadata: {
         ...params.metadata,
         [PAYKIT_METADATA_KEY]: JSON.stringify({
           item: data.item_id,
           qty: data.quantity
         })
-      },
-      customerEmail: data.customer.email
-    };
-    const response = await this._client.post(
-      "/v1/merchant/transactions/init-transaction",
-      {
-        body: JSON.stringify(body),
-        headers: await this.tokenManager.getAuthHeaders()
       }
-    );
-    const responseBody = this.ensureResponse(
-      response,
-      "createCheckout"
-    );
-    const transactionReference = responseBody.transactionReference;
-    const checkoutUrl = responseBody.checkoutUrl;
-    const checkoutResponse = await this._client.get(
-      `/v2/merchant/transactions/query?paymentReference=${paymentReference}`,
-      { headers: await this.tokenManager.getAuthHeaders() }
-    );
-    const checkoutData = this.ensureResponse(
-      checkoutResponse,
-      "createCheckout",
-      "Failed to retrieve checkout details"
-    );
-    return Checkout$inboundSchema({
-      ...checkoutData,
-      checkoutUrl,
-      transactionReference
     });
+    return Checkout$inboundSchema(transactionData);
   };
   retrieveCheckout = async (id) => {
     const transactionData = await this.queryTransaction(
@@ -393,14 +406,39 @@ var MonnifyProvider = class extends AbstractPayKitProvider {
     );
   };
   createPayment = async (params) => {
-    throw new ProviderNotSupportedError(
-      "createPayment",
-      "Moniepoint",
-      {
-        reason: "Moniepoint doesn't support creating payments",
-        alternative: "Use the createPayment method instead"
-      }
+    const data = this.validateSchema(
+      createPaymentSchema,
+      params,
+      "createPayment"
+    );
+    if (!isEmailCustomer(data.customer)) {
+      throw new InvalidTypeError(
+        "customer",
+        "object (customer) with email",
+        "string (customer ID)",
+        {
+          provider: this.providerName,
+          method: "createPayment"
+        }
+      );
+    }
+    const { success_url } = validateRequiredKeys(
+      ["success_url"],
+      data.provider_metadata ?? {},
+      "The following fields must be present in the provider_metadata of createPayment: {keys}"
     );
+    const transactionData = await this.initializeTransaction({
+      email: data.customer.email,
+      amount: data.amount.toString(),
+      currency: data.currency,
+      redirectUrl: success_url,
+      description: `Payment for ${data.item_id}`,
+      metadata: {
+        ...data.metadata,
+        [PAYKIT_METADATA_KEY]: JSON.stringify({ item: data.item_id })
+      }
+    });
+    return Payment$inboundSchema(transactionData);
   };
   retrievePayment = async (id) => {
     try {

package/dist/monnify-provider.d.mts

@@ -1,6 +1,18 @@
 import { PaykitProviderOptions, AbstractPayKitProvider, PayKitProvider, ProviderMetadataRegistry, CreateCheckoutSchema, Checkout, UpdateCheckoutSchema, CreateCustomerParams, Customer, UpdateCustomerParams, CreateSubscriptionSchema, Subscription, UpdateSubscriptionSchema, CreatePaymentSchema, Payment, UpdatePaymentSchema, CapturePaymentSchema, CreateRefundSchema, Refund, WebhookHandlerConfig, WebhookEventPayload } from '@paykit-sdk/core';
 
 interface MonnifyMetadata extends ProviderMetadataRegistry {
+    checkout?: {
+        amount?: string;
+        currency?: string;
+    };
+    payment?: {
+        /**
+         * Monnify only supports hosted/redirect transactions - a
+         * direct createPayment call still needs somewhere to send the
+         * customer, same as createCheckout's success_url.
+         */
+        success_url?: string;
+    };
 }
 interface MonnifyRawEvents extends Record<string, any> {
 }
@@ -39,6 +51,13 @@ declare class MonnifyProvider extends AbstractPayKitProvider implements PayKitPr
      * Queries transaction by transactionReference or paymentReference (with fallback)
      */
     private queryTransaction;
+    /**
+     * Monnify only has one way to move money: a hosted redirect
+     * transaction. createCheckout and createPayment both boil down to
+     * this same call - only the input validation and the response
+     * mapper differ between the two.
+     */
+    private initializeTransaction;
     createCheckout: (params: CreateCheckoutSchema) => Promise<Checkout>;
     retrieveCheckout: (id: string) => Promise<Checkout>;
     updateCheckout: (id: string, params: UpdateCheckoutSchema) => Promise<Checkout>;
@@ -52,7 +71,7 @@ declare class MonnifyProvider extends AbstractPayKitProvider implements PayKitPr
     cancelSubscription: (id: string) => Promise<Subscription>;
     deleteSubscription: (id: string) => Promise<null>;
     retrieveSubscription: (id: string) => Promise<Subscription | null>;
-    createPayment: (params: CreatePaymentSchema) => Promise<Payment>;
+    createPayment: (params: CreatePaymentSchema<MonnifyMetadata["payment"]>) => Promise<Payment>;
     retrievePayment: (id: string) => Promise<Payment | null>;
     updatePayment: (id: string, params: UpdatePaymentSchema) => Promise<Payment>;
     deletePayment: (id: string) => Promise<null>;

package/dist/monnify-provider.d.ts

@@ -1,6 +1,18 @@
 import { PaykitProviderOptions, AbstractPayKitProvider, PayKitProvider, ProviderMetadataRegistry, CreateCheckoutSchema, Checkout, UpdateCheckoutSchema, CreateCustomerParams, Customer, UpdateCustomerParams, CreateSubscriptionSchema, Subscription, UpdateSubscriptionSchema, CreatePaymentSchema, Payment, UpdatePaymentSchema, CapturePaymentSchema, CreateRefundSchema, Refund, WebhookHandlerConfig, WebhookEventPayload } from '@paykit-sdk/core';
 
 interface MonnifyMetadata extends ProviderMetadataRegistry {
+    checkout?: {
+        amount?: string;
+        currency?: string;
+    };
+    payment?: {
+        /**
+         * Monnify only supports hosted/redirect transactions - a
+         * direct createPayment call still needs somewhere to send the
+         * customer, same as createCheckout's success_url.
+         */
+        success_url?: string;
+    };
 }
 interface MonnifyRawEvents extends Record<string, any> {
 }
@@ -39,6 +51,13 @@ declare class MonnifyProvider extends AbstractPayKitProvider implements PayKitPr
      * Queries transaction by transactionReference or paymentReference (with fallback)
      */
     private queryTransaction;
+    /**
+     * Monnify only has one way to move money: a hosted redirect
+     * transaction. createCheckout and createPayment both boil down to
+     * this same call - only the input validation and the response
+     * mapper differ between the two.
+     */
+    private initializeTransaction;
     createCheckout: (params: CreateCheckoutSchema) => Promise<Checkout>;
     retrieveCheckout: (id: string) => Promise<Checkout>;
     updateCheckout: (id: string, params: UpdateCheckoutSchema) => Promise<Checkout>;
@@ -52,7 +71,7 @@ declare class MonnifyProvider extends AbstractPayKitProvider implements PayKitPr
     cancelSubscription: (id: string) => Promise<Subscription>;
     deleteSubscription: (id: string) => Promise<null>;
     retrieveSubscription: (id: string) => Promise<Subscription | null>;
-    createPayment: (params: CreatePaymentSchema) => Promise<Payment>;
+    createPayment: (params: CreatePaymentSchema<MonnifyMetadata["payment"]>) => Promise<Payment>;
     retrievePayment: (id: string) => Promise<Payment | null>;
     updatePayment: (id: string, params: UpdatePaymentSchema) => Promise<Payment>;
     deletePayment: (id: string) => Promise<null>;

package/dist/monnify-provider.js

@@ -211,6 +211,48 @@ var MonnifyProvider = class extends core.AbstractPayKitProvider {
     }
     return altResponse.value.responseBody;
   }
+  /**
+   * Monnify only has one way to move money: a hosted redirect
+   * transaction. createCheckout and createPayment both boil down to
+   * this same call - only the input validation and the response
+   * mapper differ between the two.
+   */
+  async initializeTransaction(params) {
+    const paymentReference = crypto.randomUUID();
+    const body = {
+      amount: params.amount,
+      paymentReference,
+      paymentDescription: params.description,
+      currencyCode: params.currency,
+      redirectUrl: params.redirectUrl,
+      paymentMethods: ["CARD", "ACCOUNT_TRANSFER"],
+      metadata: params.metadata,
+      customerEmail: params.email
+    };
+    const response = await this._client.post(
+      "/v1/merchant/transactions/init-transaction",
+      {
+        body: JSON.stringify(body),
+        headers: await this.tokenManager.getAuthHeaders()
+      }
+    );
+    const responseBody = this.ensureResponse(
+      response,
+      "initializeTransaction"
+    );
+    const transactionReference = responseBody.transactionReference;
+    const checkoutUrl = responseBody.checkoutUrl;
+    const transactionResponse = await this._client.get(
+      `/v2/merchant/transactions/query?paymentReference=${paymentReference}`,
+      { headers: await this.tokenManager.getAuthHeaders() }
+    );
+    const transactionData = this.ensureResponse(
+      transactionResponse,
+      "initializeTransaction",
+      "Failed to retrieve transaction details"
+    );
+    return { ...transactionData, checkoutUrl, transactionReference };
+  }
   createCheckout = async (params) => {
     const data = this.validateSchema(
       core.createCheckoutSchema,
@@ -233,50 +275,21 @@ var MonnifyProvider = class extends core.AbstractPayKitProvider {
       data.provider_metadata ?? { currency: "NGN" },
       "The following fields must be present in the provider_metadata of createCheckout: {keys}"
     );
-    const paymentReference = crypto.randomUUID();
-    const body = {
+    const transactionData = await this.initializeTransaction({
+      email: data.customer.email,
       amount,
-      paymentReference,
-      paymentDescription: `Checkout for ${data.item_id} x ${data.quantity} item${data.quantity > 1 ? "s" : ""}`,
-      currencyCode: currency,
+      currency,
       redirectUrl: data.success_url,
-      paymentMethods: ["CARD", "ACCOUNT_TRANSFER"],
+      description: `Checkout for ${data.item_id} x ${data.quantity} item${data.quantity > 1 ? "s" : ""}`,
       metadata: {
         ...params.metadata,
         [core.PAYKIT_METADATA_KEY]: JSON.stringify({
           item: data.item_id,
           qty: data.quantity
         })
-      },
-      customerEmail: data.customer.email
-    };
-    const response = await this._client.post(
-      "/v1/merchant/transactions/init-transaction",
-      {
-        body: JSON.stringify(body),
-        headers: await this.tokenManager.getAuthHeaders()
       }
-    );
-    const responseBody = this.ensureResponse(
-      response,
-      "createCheckout"
-    );
-    const transactionReference = responseBody.transactionReference;
-    const checkoutUrl = responseBody.checkoutUrl;
-    const checkoutResponse = await this._client.get(
-      `/v2/merchant/transactions/query?paymentReference=${paymentReference}`,
-      { headers: await this.tokenManager.getAuthHeaders() }
-    );
-    const checkoutData = this.ensureResponse(
-      checkoutResponse,
-      "createCheckout",
-      "Failed to retrieve checkout details"
-    );
-    return Checkout$inboundSchema({
-      ...checkoutData,
-      checkoutUrl,
-      transactionReference
     });
+    return Checkout$inboundSchema(transactionData);
   };
   retrieveCheckout = async (id) => {
     const transactionData = await this.queryTransaction(
@@ -395,14 +408,39 @@ var MonnifyProvider = class extends core.AbstractPayKitProvider {
     );
   };
   createPayment = async (params) => {
-    throw new core.ProviderNotSupportedError(
-      "createPayment",
-      "Moniepoint",
-      {
-        reason: "Moniepoint doesn't support creating payments",
-        alternative: "Use the createPayment method instead"
-      }
+    const data = this.validateSchema(
+      core.createPaymentSchema,
+      params,
+      "createPayment"
+    );
+    if (!core.isEmailCustomer(data.customer)) {
+      throw new core.InvalidTypeError(
+        "customer",
+        "object (customer) with email",
+        "string (customer ID)",
+        {
+          provider: this.providerName,
+          method: "createPayment"
+        }
+      );
+    }
+    const { success_url } = core.validateRequiredKeys(
+      ["success_url"],
+      data.provider_metadata ?? {},
+      "The following fields must be present in the provider_metadata of createPayment: {keys}"
     );
+    const transactionData = await this.initializeTransaction({
+      email: data.customer.email,
+      amount: data.amount.toString(),
+      currency: data.currency,
+      redirectUrl: success_url,
+      description: `Payment for ${data.item_id}`,
+      metadata: {
+        ...data.metadata,
+        [core.PAYKIT_METADATA_KEY]: JSON.stringify({ item: data.item_id })
+      }
+    });
+    return Payment$inboundSchema(transactionData);
   };
   retrievePayment = async (id) => {
     try {

package/dist/monnify-provider.mjs

@@ -1,4 +1,4 @@
-import { schema, Schema, AbstractPayKitProvider, HTTPClient, OAuth2TokenManager, ValidationError, OperationFailedError, createCheckoutSchema, isEmailCustomer, InvalidTypeError, validateRequiredKeys, PAYKIT_METADATA_KEY, ProviderNotSupportedError, createRefundSchema, WebhookError, parseJSON, omitInternalMetadata } from '@paykit-sdk/core';
+import { schema, Schema, AbstractPayKitProvider, HTTPClient, OAuth2TokenManager, ValidationError, OperationFailedError, createCheckoutSchema, isEmailCustomer, InvalidTypeError, validateRequiredKeys, PAYKIT_METADATA_KEY, ProviderNotSupportedError, createPaymentSchema, createRefundSchema, WebhookError, parseJSON, omitInternalMetadata } from '@paykit-sdk/core';
 import { timingSafeEqual } from 'crypto';
 import { sha512 } from 'js-sha512';
 
@@ -209,6 +209,48 @@ var MonnifyProvider = class extends AbstractPayKitProvider {
     }
     return altResponse.value.responseBody;
   }
+  /**
+   * Monnify only has one way to move money: a hosted redirect
+   * transaction. createCheckout and createPayment both boil down to
+   * this same call - only the input validation and the response
+   * mapper differ between the two.
+   */
+  async initializeTransaction(params) {
+    const paymentReference = crypto.randomUUID();
+    const body = {
+      amount: params.amount,
+      paymentReference,
+      paymentDescription: params.description,
+      currencyCode: params.currency,
+      redirectUrl: params.redirectUrl,
+      paymentMethods: ["CARD", "ACCOUNT_TRANSFER"],
+      metadata: params.metadata,
+      customerEmail: params.email
+    };
+    const response = await this._client.post(
+      "/v1/merchant/transactions/init-transaction",
+      {
+        body: JSON.stringify(body),
+        headers: await this.tokenManager.getAuthHeaders()
+      }
+    );
+    const responseBody = this.ensureResponse(
+      response,
+      "initializeTransaction"
+    );
+    const transactionReference = responseBody.transactionReference;
+    const checkoutUrl = responseBody.checkoutUrl;
+    const transactionResponse = await this._client.get(
+      `/v2/merchant/transactions/query?paymentReference=${paymentReference}`,
+      { headers: await this.tokenManager.getAuthHeaders() }
+    );
+    const transactionData = this.ensureResponse(
+      transactionResponse,
+      "initializeTransaction",
+      "Failed to retrieve transaction details"
+    );
+    return { ...transactionData, checkoutUrl, transactionReference };
+  }
   createCheckout = async (params) => {
     const data = this.validateSchema(
       createCheckoutSchema,
@@ -231,50 +273,21 @@ var MonnifyProvider = class extends AbstractPayKitProvider {
       data.provider_metadata ?? { currency: "NGN" },
       "The following fields must be present in the provider_metadata of createCheckout: {keys}"
     );
-    const paymentReference = crypto.randomUUID();
-    const body = {
+    const transactionData = await this.initializeTransaction({
+      email: data.customer.email,
       amount,
-      paymentReference,
-      paymentDescription: `Checkout for ${data.item_id} x ${data.quantity} item${data.quantity > 1 ? "s" : ""}`,
-      currencyCode: currency,
+      currency,
       redirectUrl: data.success_url,
-      paymentMethods: ["CARD", "ACCOUNT_TRANSFER"],
+      description: `Checkout for ${data.item_id} x ${data.quantity} item${data.quantity > 1 ? "s" : ""}`,
       metadata: {
         ...params.metadata,
         [PAYKIT_METADATA_KEY]: JSON.stringify({
           item: data.item_id,
           qty: data.quantity
         })
-      },
-      customerEmail: data.customer.email
-    };
-    const response = await this._client.post(
-      "/v1/merchant/transactions/init-transaction",
-      {
-        body: JSON.stringify(body),
-        headers: await this.tokenManager.getAuthHeaders()
       }
-    );
-    const responseBody = this.ensureResponse(
-      response,
-      "createCheckout"
-    );
-    const transactionReference = responseBody.transactionReference;
-    const checkoutUrl = responseBody.checkoutUrl;
-    const checkoutResponse = await this._client.get(
-      `/v2/merchant/transactions/query?paymentReference=${paymentReference}`,
-      { headers: await this.tokenManager.getAuthHeaders() }
-    );
-    const checkoutData = this.ensureResponse(
-      checkoutResponse,
-      "createCheckout",
-      "Failed to retrieve checkout details"
-    );
-    return Checkout$inboundSchema({
-      ...checkoutData,
-      checkoutUrl,
-      transactionReference
     });
+    return Checkout$inboundSchema(transactionData);
   };
   retrieveCheckout = async (id) => {
     const transactionData = await this.queryTransaction(
@@ -393,14 +406,39 @@ var MonnifyProvider = class extends AbstractPayKitProvider {
     );
   };
   createPayment = async (params) => {
-    throw new ProviderNotSupportedError(
-      "createPayment",
-      "Moniepoint",
-      {
-        reason: "Moniepoint doesn't support creating payments",
-        alternative: "Use the createPayment method instead"
-      }
+    const data = this.validateSchema(
+      createPaymentSchema,
+      params,
+      "createPayment"
+    );
+    if (!isEmailCustomer(data.customer)) {
+      throw new InvalidTypeError(
+        "customer",
+        "object (customer) with email",
+        "string (customer ID)",
+        {
+          provider: this.providerName,
+          method: "createPayment"
+        }
+      );
+    }
+    const { success_url } = validateRequiredKeys(
+      ["success_url"],
+      data.provider_metadata ?? {},
+      "The following fields must be present in the provider_metadata of createPayment: {keys}"
     );
+    const transactionData = await this.initializeTransaction({
+      email: data.customer.email,
+      amount: data.amount.toString(),
+      currency: data.currency,
+      redirectUrl: success_url,
+      description: `Payment for ${data.item_id}`,
+      metadata: {
+        ...data.metadata,
+        [PAYKIT_METADATA_KEY]: JSON.stringify({ item: data.item_id })
+      }
+    });
+    return Payment$inboundSchema(transactionData);
   };
   retrievePayment = async (id) => {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paykit-sdk/monnify",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Moniepoint provider for PayKit",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -27,7 +27,7 @@
   "devDependencies": {
     "tsup": "^8.5.0",
     "typescript": "^5.9.2",
-    "@paykit-sdk/core": "1.3.0"
+    "@paykit-sdk/core": "1.3.1"
   },
   "dependencies": {
     "js-sha512": "^0.9.0"