@vaam-apps/vpay-sdk 0.12.1 → 0.14.0

package/dist/index.d.ts

@@ -11,5 +11,5 @@ export { verifyWebhook, type VerifyWebhookOptions } from "./webhooks.js";
 /** This package's own version, as sent in the `vpay-sdk-node/<version>` User-Agent. */
 export { SDK_VERSION } from "./version.js";
 export { VpayError, VpayApiError, VpayAuthError, VpayUnexpectedResponseError, VpayTransportError, VpayConfigError, VpayInvalidParamsError, WebhookSignatureError, } from "./errors.js";
-export type { AccountHolder, RetrieveAccountHolderParams, CheckoutSession, CheckoutSessionStatus, CheckoutSessionUiMode, CheckoutPaymentStatus, CreateCheckoutSessionParams, ListCheckoutSessionsParams, Customer, DeletedCustomer, Address, AddressParams, CreateCustomerParams, UpdateCustomerParams, ListCustomersParams, Invoice, InvoiceLine, InvoiceStatus, InvoiceStatusTransitions, DeletedInvoice, DeletedInvoiceItem, CreateInvoiceParams, UpdateInvoiceParams, ListInvoicesParams, PayInvoiceParams, HostedPayInvoiceParams, OutOfBandPayInvoiceParams, OutOfBandParams, OutOfBandMethod, OutOfBandPayment, CreateInvoiceItemParams, UpdateInvoiceItemParams, PaymentIntent, PaymentIntentStatus, PaymentMethodType, NextAction, LastPaymentError, FailureCode, Refund, RefundStatus, Event, KnownEventType, Balance, BalanceAmount, List, ListParams, ListPaymentIntentsParams, ListEventsParams, CreatePaymentIntentParams, ConfirmPaymentIntentParams, MtnMomoPaymentMethodData, OrangeMoneyPaymentMethodData, CreateRefundParams, RefundDestination, UpdateRefundParams, ListRefundsParams, RequestOptions, } from "./types.js";
+export type { AccountHolder, RetrieveAccountHolderParams, CheckoutSession, CheckoutSessionStatus, CheckoutSessionUiMode, CheckoutPaymentStatus, CreateCheckoutSessionParams, ListCheckoutSessionsParams, Customer, DeletedCustomer, Address, AddressParams, CreateCustomerParams, UpdateCustomerParams, ListCustomersParams, Invoice, InvoiceLine, InvoiceStatus, InvoiceStatusTransitions, DeletedInvoice, DeletedInvoiceItem, CreateInvoiceParams, UpdateInvoiceParams, ListInvoicesParams, PayInvoiceParams, HostedPayInvoiceParams, OutOfBandPayInvoiceParams, OutOfBandParams, OutOfBandMethod, OutOfBandPayment, CreateInvoiceItemParams, UpdateInvoiceItemParams, PaymentIntent, PaymentIntentStatus, PaymentMethodDetails, PaymentMethodType, NextAction, LastPaymentError, FailureCode, Refund, RefundStatus, Event, KnownEventType, Balance, BalanceAmount, List, ListParams, ListPaymentIntentsParams, ListEventsParams, CreatePaymentIntentParams, ConfirmPaymentIntentParams, MtnMomoPaymentMethodData, OrangeMoneyPaymentMethodData, CreateRefundParams, RefundDestination, UpdateRefundParams, ListRefundsParams, RequestOptions, } from "./types.js";
 export { isCheckoutSessionEvent, isInvoiceEvent, isPaymentIntentEvent, isRefundEvent, } from "./types.js";

package/dist/types.d.ts

@@ -54,6 +54,23 @@ export interface LastPaymentError {
     code: FailureCode;
     message: string;
 }
+/**
+ * What a {@link PaymentIntent}'s one charge was made with (vpay since
+ * 2026-10-24): the payment-method type the payer used and the rail vpay
+ * charged it on. The outcome of routing; why that rail won is not on the API.
+ */
+export interface PaymentMethodDetails {
+    /**
+     * The charge's payment-method type (`"mtn_wallet"`, `"orange_wallet"`), or
+     * `null` where the charge records none: one confirmed by the code of a rail
+     * serving several types (`notchpay`), or made before vpay recorded types.
+     * A `string` rather than a closed union, so a type this SDK predates still
+     * type-checks.
+     */
+    type: string | null;
+    /** The code of the rail the charge was made on (`"mtn_momo"`, `"notchpay"`, …). */
+    rail: string;
+}
 export interface PaymentIntent {
     id: string;
     object: "payment_intent";
@@ -63,6 +80,14 @@ export interface PaymentIntent {
     currency: string;
     status: PaymentIntentStatus;
     payment_method_types: string[];
+    /**
+     * What the intent's one charge was made with, or `null` while it has none.
+     *
+     * `?` because a vpay predating 2026-10-24 omits the key entirely, for
+     * {@link PaymentIntent.customer}'s reason: `undefined` and `null` both mean
+     * "no charge to describe".
+     */
+    payment_method_details?: PaymentMethodDetails | null;
     next_action: NextAction | null;
     last_payment_error: LastPaymentError | null;
     metadata: Record<string, string>;
@@ -1280,8 +1305,9 @@ export type ListCheckoutSessionsParams = {
  * On the wire this is `destination[<rail code>][…]` — a rail-agnostic
  * container with a rail-specific interior, much as
  * `payment_method_data[<payment_method_type>][…]` is on the confirm path. The
- * outer key is always the code of the **rail** the charge was made on, never a
- * payment-method type: the server refuses `destination[mtn_wallet]`. The
+ * outer key is the code of the **rail** the charge was made on or, since the
+ * server's 2026-10-24 change, the payment-method type the charge records
+ * (`destination[mtn_wallet]` for a charge routed by `mtn_wallet`). The
  * server strips the outer key and hands the interior to that rail's own
  * adapter, which is the only thing that knows what a payee looks like there.
  * An SDK that flattened this, or that wrote one rail's code into the body
@@ -1337,16 +1363,17 @@ export type RefundDestination = {
     /**
      * The rail the charge was made on — its code becomes the outer key.
      *
-     * A **rail code** (`"mtn_momo"`, `"orange_money"`, `"notchpay"`), never a
-     * payment-method type: `"mtn_wallet"` or `"orange_wallet"` here is refused by
-     * the server with a `400` naming `destination`. For an intent created with a
-     * type, the rail its charge was routed to is on no `/v1` object yet, so the
-     * caller has to know it another way.
+     * A **rail code** (`"mtn_momo"`, `"orange_money"`, `"notchpay"`), or the
+     * payment-method type the charge records (`"mtn_wallet"`, `"orange_wallet"`):
+     * a server since 2026-10-24 accepts the type for a charge routed by it, which
+     * is how to refund one without knowing the rail it went to (no `/v1` object
+     * names that rail yet). Another type, or a type on an older server, is
+     * refused with a `400` naming `destination`.
      */
     payment_method_type: PaymentMethodType;
     /**
      * The payee's number, **in international form, starting with `+`**. Sent as
-     * `destination[<rail code>][msisdn]`.
+     * `destination[<rail code or method type>][msisdn]`.
      */
     msisdn: string;
 };

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.12.1";
+export declare const SDK_VERSION = "0.14.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.12.1"; // x-release-please-version
+export const SDK_VERSION = "0.14.0"; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vaam-apps/vpay-sdk",
-  "version": "0.12.1",
+  "version": "0.14.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": {