@vaam-apps/vpay-sdk 0.8.0 → 0.9.0

package/dist/resources/refunds.d.ts

@@ -10,6 +10,9 @@
  *
  * - `orange_money`'s refund is a declared `NotImplemented` token — an Orange
  *   refund is an outbound transfer this repository has no specification for;
+ * - `notchpay`'s refund is a declared `NotImplemented` token too — Notch Pay
+ *   documents refunds in a guide only, with nothing that makes a replay safe
+ *   (RFC-0012 § 7);
  * - `mtn_momo`'s is MTN's Disbursements `transfer`, WireMock-proven and
  *   rail-unproven: **no real MTN Disbursements credential exists in this
  *   project** — the only `disbursement_subscription_key` anywhere is the stub

package/dist/types.d.ts

@@ -10,7 +10,7 @@
  */
 export type PaymentIntentStatus = "requires_payment_method" | "requires_action" | "processing" | "succeeded" | "canceled";
 /** Rail codes this SDK's `payment_method_types` values may hold. */
-export type PaymentMethodType = "mtn_momo" | "orange_money";
+export type PaymentMethodType = "mtn_momo" | "orange_money" | "notchpay";
 /** Redirect-rail next step, Stripe's own `next_action.redirect_to_url` shape. */
 export interface NextAction {
     type: "redirect_to_url";
@@ -1161,8 +1161,21 @@ export type MtnMomoPaymentMethodData = {
 export type OrangeMoneyPaymentMethodData = {
     type: "orange_money";
 };
+/**
+ * Notch Pay (RFC-0012, 2026-10-20): a push rail, so the same instrument as
+ * MTN's, under this rail's own code. The server's adapter is proven against a
+ * stub only and has never called Notch Pay.
+ */
+export type NotchPayPaymentMethodData = {
+    type: "notchpay";
+    notchpay: {
+        msisdn: string;
+    };
+};
 export type ConfirmPaymentIntentParams = {
     payment_method_data: MtnMomoPaymentMethodData;
+} | {
+    payment_method_data: NotchPayPaymentMethodData;
 } | {
     payment_method_data: OrangeMoneyPaymentMethodData;
     return_url: string;
@@ -1323,8 +1336,8 @@ export type RefundDestination = {
  * # No refund this creates has ever moved money
  *
  * The route is real and so is every refusal it makes, but nothing on the
- * other side of it pays anybody: `orange_money`'s refund is a declared
- * `NotImplemented` token, `mtn_momo`'s is MTN's Disbursements `transfer`
+ * other side of it pays anybody: `orange_money`'s and `notchpay`'s refunds
+ * are declared `NotImplemented` tokens, `mtn_momo`'s is MTN's Disbursements `transfer`
  * which is WireMock-proven and for which **no real MTN credential exists in
  * this project** — the only `disbursement_subscription_key` anywhere is the
  * stub the e2e/demo stack points at a WireMock container, and the product has
@@ -1352,10 +1365,12 @@ export interface CreateRefundParams {
      *
      * Optional because the port allows a rail that refunds to the instrument
      * that paid, and such a rail refuses a `destination` with a `400`.
-     * **Neither rail vpay carries today is one**: `mtn_momo` and `orange_money`
-     * both declare that a refund needs a payee, so a create with no
-     * `destination` is a `400` naming `destination` against every deployment
-     * this repository can build.
+     * `mtn_momo` and `orange_money` both declare that a refund needs a payee,
+     * so a create with no `destination` is a `400` naming `destination` on
+     * either. `notchpay` (2026-10-20) is the first shipping rail that refunds
+     * to the instrument that paid and so refuses one — but its refund is a
+     * declared `NotImplemented` token, so a refund there fails whatever it
+     * carries.
      */
     destination?: RefundDestination | undefined;
     metadata?: Record<string, string> | undefined;

package/dist/version.d.ts

@@ -9,4 +9,4 @@
  * releases. A hand-written constant has no such landmine — it just needs to
  * be bumped alongside `package.json`'s own `version` field.
  */
-export declare const SDK_VERSION = "0.8.0";
+export declare const SDK_VERSION = "0.9.0";

package/dist/version.js

@@ -9,4 +9,4 @@
  * releases. A hand-written constant has no such landmine — it just needs to
  * be bumped alongside `package.json`'s own `version` field.
  */
-export const SDK_VERSION = "0.8.0"; // x-release-please-version
+export const SDK_VERSION = "0.9.0"; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaam-apps/vpay-sdk",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "The Node.js merchant SDK for vpay's /v1 API: OAuth2 private_key_jwt, payment intents, checkout sessions, refunds, events and webhook verification.",
   "license": "Apache-2.0",
   "publishConfig": {