@sakeetech/viva-payments-core 0.2.1

package/dist/types/isv-payments.d.ts

@@ -0,0 +1,262 @@
+/**
+ * ISV Payment API request and response types.
+ *
+ * Covers: CreatePaymentOrder, RetrieveTransaction, RefundTransaction,
+ * CancelOrder. All amounts are in integer minor units (bigint) per plan P15.
+ *
+ * The ISV Payment API uses the same Smart Checkout order-creation endpoint
+ * as the standard Payment API but with an additional `merchantId` query
+ * parameter to scope the payment to a specific connected merchant.
+ *
+ * Type attribution: structure referenced from @nkhind/vivawallet-sdk with
+ * fresh hand-rolled definitions. No code copied.
+ *
+ * @see references/viva-docs/md/payment-isv-api.txt:1
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:158
+ * @see references/viva-docs/md/webhooks-for-payments.txt:248
+ */
+import type { CurrencyCode, MinorUnits, OrderCode, TransactionId } from './common.js';
+/**
+ * Request body for ISV Create Payment Order.
+ *
+ * Sent as `POST /checkout/v2/orders?merchantId={merchantId}` with a bearer
+ * token. The `amount` field MUST be in integer minor units (e.g. 1234 for
+ * EUR 12.34). The `currencyCode` is the ISO 4217 numeric string.
+ *
+ * @see references/viva-docs/md/payment-isv-api.txt:1
+ */
+export interface CreateOrderRequest {
+    /**
+     * Payment amount in integer minor units.
+     * Wire format is a JSON integer; internally held as bigint.
+     * Example: 1234 for EUR 12.34.
+     */
+    readonly amount: MinorUnits;
+    /**
+     * ISO 4217 numeric currency code string (e.g. "978" for EUR).
+     *
+     * @see references/viva-docs/md/wh-transaction-payment-created.txt:487
+     */
+    readonly currencyCode: CurrencyCode;
+    /**
+     * Merchant-facing transaction reference (max 50 chars).
+     * Stored on the order and returned in webhook EventData.MerchantTrns.
+     */
+    readonly merchantTrns?: string;
+    /**
+     * Customer-facing transaction description shown on Smart Checkout page
+     * and bank statement (max 255 chars).
+     */
+    readonly customerTrns?: string;
+    /** Customer email used for receipt and 3DS. */
+    readonly customerEmail?: string;
+    /** Customer phone number. */
+    readonly customerPhone?: string;
+    /** Customer full name. */
+    readonly customerFullName?: string;
+    /**
+     * URL to redirect the customer after successful payment.
+     * If omitted, Viva uses the source's configured success URL.
+     */
+    readonly successUrl?: string;
+    /**
+     * URL to redirect the customer after payment failure.
+     * If omitted, Viva uses the source's configured failure URL.
+     */
+    readonly failureUrl?: string;
+    /**
+     * Arbitrary tags for reporting purposes (max 10 entries, each max 50 chars).
+     *
+     * @see references/viva-docs/md/wh-transaction-payment-created.txt:218
+     */
+    readonly tags?: readonly string[];
+    /**
+     * Payment source code. Required for physical-location ISV sources.
+     * Omit to use the account default ("Default") source.
+     *
+     * @see references/viva-docs/md/payment-source-for-isv.txt:101
+     */
+    readonly sourceCode?: string;
+    /**
+     * Number of installments (1 = no installments).
+     * Must be agreed with Viva; not supported in all markets.
+     */
+    readonly paymentTimeoutSeconds?: number;
+    /** Pre-selected payment method (e.g. 'card'). */
+    readonly preselectedPaymentMethod?: string;
+    /**
+     * ISV fee in integer minor units. ISV-mode only.
+     *
+     * Stripped from the wire body when `Payments.mode === 'merchant'` — only
+     * sent on `POST /checkout/v2/isv/orders` calls. Callers may set this on a
+     * single `CreateOrderRequest` regardless of mode; the client will drop it
+     * in merchant mode and forward it in ISV mode.
+     *
+     * @see references/viva-docs/md/isv-partner-program.txt:296
+     */
+    readonly isvAmount?: MinorUnits;
+}
+/**
+ * Response from ISV Create Payment Order.
+ *
+ * On success (HTTP 200), Viva returns an `orderCode` which serves as the
+ * unique identifier of the created order. Build the Smart Checkout redirect
+ * URL as: `{smartCheckoutBaseUrl}?ref={orderCode}&color=%23{hex}`.
+ *
+ * @see references/viva-docs/md/payment-isv-api.txt:1
+ */
+export interface CreateOrderResponse {
+    /**
+     * Order code (int64) uniquely identifying this payment order globally.
+     * Used to build the Smart Checkout redirect URL and correlate webhooks.
+     * Stored as bigint to preserve precision.
+     *
+     * @see references/viva-docs/md/wh-transaction-payment-created.txt:176
+     */
+    readonly orderCode: OrderCode;
+}
+/**
+ * Response from ISV Retrieve Transaction Details.
+ *
+ * Call as `GET /checkout/v2/transactions/{transactionId}?merchantId={merchantId}`.
+ * Per Viva docs, this SHOULD be called before updating local state on any
+ * webhook delivery.
+ *
+ * @see references/viva-docs/md/webhooks-for-payments.txt:248
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:119
+ */
+export interface RetrieveTransactionResponse {
+    /** Unique transaction identifier. */
+    readonly transactionId: TransactionId;
+    /** The order this transaction belongs to. */
+    readonly orderCode: OrderCode;
+    /**
+     * Transaction status letter from Viva.
+     * Use `VivaStatusLetter` from status.ts for the exhaustive set.
+     *
+     * @see references/viva-docs/md/wh-transaction-payment-created.txt:398
+     */
+    readonly statusId: string;
+    /**
+     * Transaction amount in integer minor units.
+     * NOTE: Viva docs show `Amount` as `decimal` in some webhook payloads but
+     * the createOrder request uses integer minor units. Treat as minor units
+     * unless a live demo payment confirms otherwise.
+     *
+     * TODO(impl): verify Amount unit (minor int vs major decimal) against
+     * first real demo payment end-to-end.
+     * @see references/viva-docs/md/wh-transaction-payment-created.txt:345
+     */
+    readonly amount: MinorUnits;
+    /** ISO 4217 numeric currency code. */
+    readonly currencyCode: CurrencyCode;
+    /** Merchant ID that owns this transaction. */
+    readonly merchantId: string;
+    /** Parent transaction ID if this is a refund. */
+    readonly parentId: TransactionId | null;
+    /** ISO 8601 timestamp when the transaction was inserted. */
+    readonly insDate: string;
+    /** Transaction type numeric identifier. */
+    readonly transactionTypeId: number;
+    /** Masked card number (e.g. "414746XXXXXX0133"). */
+    readonly cardNumber?: string;
+    /** Card type identifier (0=Visa, 1=Mastercard, etc.). */
+    readonly cardTypeId?: number;
+    /**
+     * Card scheme name derived from `cardTypeId` via
+     * {@link import('./card-types.js').resolveCardType resolveCardType}.
+     *
+     * Emitted as `'Visa' | 'MasterCard' | 'Maestro' | 'Amex' | 'Diners' |
+     * 'Discover' | 'JCB'` for known card schemes. `undefined` when the
+     * upstream `cardTypeId` is absent, `4` (Invalid), `5` (Unknown), or any
+     * value not in the documented mapping.
+     *
+     * Consumed by `resolveRefundStrategy()` in the refunds module to decide
+     * Fast vs Standard refund routing.
+     *
+     * @see ./card-types.ts
+     * @see ../refunds/strategy.ts
+     */
+    readonly cardType?: string;
+    /** Customer email. */
+    readonly email?: string;
+    /** Customer full name. */
+    readonly fullName?: string;
+    /** Merchant-facing reference string. */
+    readonly merchantTrns?: string;
+    /** Customer-facing reference string. */
+    readonly customerTrns?: string;
+    /** Connected account ID if ISV scoped. */
+    readonly connectedAccountId?: string;
+}
+/**
+ * Request body for ISV Refund Transaction.
+ *
+ * Sent as `POST /checkout/v2/transactions/{transactionId}` with a bearer
+ * or reseller token. Partial refunds are supported by specifying `amount`.
+ * If `amount` is omitted, a full refund is issued.
+ *
+ * Per plan P18: validate `amount <= (captured - already_refunded)` before
+ * calling Viva. ISV fee reverses automatically on full/partial refund.
+ *
+ * @see references/viva-docs/md/isv-partner-program.txt:296
+ */
+export interface RefundRequest {
+    /**
+     * Refund amount in integer minor units.
+     * Must be <= (captured_amount - already_refunded_amount).
+     * Omit for a full refund.
+     */
+    readonly amount?: MinorUnits;
+    /** Merchant reference for this refund. */
+    readonly merchantTrns?: string;
+    /** Customer reference for this refund. */
+    readonly customerTrns?: string;
+    /** Source code. Required for ISV refunds in some configurations. */
+    readonly sourceCode?: string;
+}
+/**
+ * Response from ISV Refund Transaction.
+ *
+ * Returned by the legacy `POST /api/transactions/{transactionId}` endpoint.
+ * Viva returns PascalCase field names; the SDK normalises to camelCase.
+ *
+ * Probe-verified 2026-04-25: the legacy endpoint is the ONLY supported refund path.
+ * `POST /checkout/v2/transactions/{id}` (v2/OAuth2) returns 405 on Viva sandbox.
+ *
+ * @see references/viva-docs/md/tut-create-recurring-payment.txt:288
+ */
+export interface RefundResponse {
+    /** ID of the newly created refund transaction. */
+    readonly transactionId: TransactionId;
+    /** Viva status identifier for the refund transaction. */
+    readonly statusId?: string;
+    /** Refunded amount in minor units (echoed from request). */
+    readonly amount?: MinorUnits;
+}
+/**
+ * Response from ISV Cancel Order.
+ *
+ * Sent as `DELETE /checkout/v2/orders/{orderCode}?merchantId={merchantId}`.
+ * Used for orders that have not yet been paid. Idempotent — cancelling an
+ * already-cancelled or captured order returns the existing Viva response.
+ *
+ * Note: per plan Q5, cancelOrder may require ResellerBasicAuthStrategy.
+ * Confirm during S2/S3 implementation.
+ *
+ * @see references/viva-docs/md/payment-isv-api.txt:1
+ */
+export interface CancelOrderResponse {
+    /** Order code of the cancelled order. */
+    readonly orderCode: OrderCode;
+    /**
+     * HTTP status code returned by Viva.
+     * Typically 200 on success.
+     *
+     * TODO(impl): verify exact response body shape for cancelOrder via demo.
+     * @see references/viva-docs/md/payment-isv-api.txt:1
+     */
+    readonly errorCode: number;
+    readonly errorText: string;
+}
+//# sourceMappingURL=isv-payments.d.ts.map

package/dist/types/isv-payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isv-payments.d.ts","sourceRoot":"","sources":["../../src/types/isv-payments.ts"],"names":[],"mappings":"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"}

package/dist/types/isv-payments.js

@@ -0,0 +1,19 @@
+/**
+ * ISV Payment API request and response types.
+ *
+ * Covers: CreatePaymentOrder, RetrieveTransaction, RefundTransaction,
+ * CancelOrder. All amounts are in integer minor units (bigint) per plan P15.
+ *
+ * The ISV Payment API uses the same Smart Checkout order-creation endpoint
+ * as the standard Payment API but with an additional `merchantId` query
+ * parameter to scope the payment to a specific connected merchant.
+ *
+ * Type attribution: structure referenced from @nkhind/vivawallet-sdk with
+ * fresh hand-rolled definitions. No code copied.
+ *
+ * @see references/viva-docs/md/payment-isv-api.txt:1
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:158
+ * @see references/viva-docs/md/webhooks-for-payments.txt:248
+ */
+export {};
+//# sourceMappingURL=isv-payments.js.map

package/dist/types/isv-payments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isv-payments.js","sourceRoot":"","sources":["../../src/types/isv-payments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/types/status.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Viva transaction status letter mapping and plugin status enum.
+ *
+ * Implements plan P17: maps Viva's raw `StatusId` letter codes to the
+ * plugin's canonical `VivaTransactionStatus` enum. The M-family letters
+ * (M, MA, MI, ML, MS, MW) all map to `'disputed'` with the specific
+ * letter stored in `claim_substate`.
+ *
+ * Implements plan A9: adds `authorized → cancelled` transition
+ * (void-before-capture).
+ *
+ * The actual runtime `mapStatusLetter` function lives in S4
+ * (src/webhooks/status-lattice.ts). This file is types only.
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:398
+ * @see references/viva-docs/md/wh-sale-transactions.txt:210
+ */
+/**
+ * Viva `StatusId` string values as documented.
+ *
+ * Single-letter values:
+ *   F = Finished (captured/completed)
+ *   A = Active (authorized, awaiting capture)
+ *   C = Captured
+ *   E = Error (failed)
+ *   R = Refunded
+ *   X = Cancelled
+ *
+ * Claim/dispute multi-letter values:
+ *   M   = Claimed
+ *   MA  = Claim Awaiting Response
+ *   MI  = Claim In Progress
+ *   ML  = Claim Lost
+ *   MS  = Suspected Claimed
+ *   MW  = Claim Won
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:398
+ */
+export type VivaStatusLetter = 'F' | 'A' | 'C' | 'E' | 'R' | 'X' | 'M' | 'MA' | 'MI' | 'ML' | 'MS' | 'MW';
+/**
+ * Plugin canonical transaction status enum.
+ *
+ * This is what viva_transaction.status stores in the database.
+ * Defined as string literals for direct SQL/JSON compatibility.
+ *
+ * Monotonic lattice (plan A9):
+ *   initiated → authorized → captured → refunded   (terminal)
+ *                          → cancelled             (terminal)
+ *                          → disputed +substate    (terminal from captured)
+ *            → failed                              (terminal)
+ *   authorized → cancelled                         (void-before-capture)
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:398
+ */
+export type VivaTransactionStatus = 'initiated' | 'authorized' | 'captured' | 'refunded' | 'cancelled' | 'failed' | 'disputed';
+/**
+ * The claim sub-states for disputed transactions.
+ * Stored in viva_transaction.claim_substate when status = 'disputed'.
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:411
+ */
+export type VivaClaimSubstate = 'M' | 'MA' | 'MI' | 'ML' | 'MS' | 'MW';
+/**
+ * Type-level mapping from VivaStatusLetter to VivaTransactionStatus.
+ * Used as documentation and compile-time reference for S4 implementors.
+ *
+ * Runtime function `mapStatusLetter(letter) → VivaTransactionStatus` lives in:
+ *   packages/viva-payments-core/src/webhooks/status-lattice.ts
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:398
+ */
+export type StatusLetterToTransactionStatus = {
+    readonly F: 'captured';
+    readonly A: 'authorized';
+    readonly C: 'captured';
+    readonly E: 'failed';
+    readonly R: 'refunded';
+    readonly X: 'cancelled';
+    readonly M: 'disputed';
+    readonly MA: 'disputed';
+    readonly MI: 'disputed';
+    readonly ML: 'disputed';
+    readonly MS: 'disputed';
+    readonly MW: 'disputed';
+};
+/**
+ * Status letters that map to the `'disputed'` plugin status.
+ * The specific letter MUST be preserved in `claim_substate`.
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:411
+ */
+export type ClaimStatusLetter = 'M' | 'MA' | 'MI' | 'ML' | 'MS' | 'MW';
+/**
+ * Terminal statuses — once reached, no further transitions are allowed.
+ * The monotonic lattice in status-lattice.ts enforces this invariant.
+ *
+ * @see Plan P17, Plan A9
+ */
+export type TerminalVivaTransactionStatus = 'captured' | 'refunded' | 'cancelled' | 'failed' | 'disputed';
+/**
+ * Non-terminal statuses — transitions out of these are allowed.
+ */
+export type NonTerminalVivaTransactionStatus = Exclude<VivaTransactionStatus, TerminalVivaTransactionStatus>;
+/**
+ * A status transition — from a non-terminal state to any target state.
+ * The status-lattice runtime validates this against the allowed lattice.
+ */
+export interface StatusTransition {
+    readonly from: VivaTransactionStatus;
+    readonly to: VivaTransactionStatus;
+}
+/**
+ * Result of applying a status letter to the current lattice state.
+ * If `allowed` is false, the transition is a no-op and should be logged
+ * as a warning (backwards transition attempt).
+ */
+export type StatusTransitionResult = {
+    readonly allowed: true;
+    readonly nextStatus: VivaTransactionStatus;
+    readonly claimSubstate?: VivaClaimSubstate;
+} | {
+    readonly allowed: false;
+    readonly reason: string;
+};
+//# sourceMappingURL=status.d.ts.map

package/dist/types/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/types/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,gBAAgB,GACxB,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAMT;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,qBAAqB,GAC7B,WAAW,GACX,YAAY,GACZ,UAAU,GACV,UAAU,GACV,WAAW,GACX,QAAQ,GACR,UAAU,CAAC;AAEf;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAMvE;;;;;;;;GAQG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC;IACvB,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC;IACzB,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC;IACvB,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC;IACrB,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC;IACvB,QAAQ,CAAC,CAAC,EAAE,WAAW,CAAC;IACxB,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,MAAM,6BAA6B,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE1G;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,OAAO,CAAC,qBAAqB,EAAE,6BAA6B,CAAC,CAAC;AAE7G;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,EAAE,EAAE,qBAAqB,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAA;CAAE,GAClH;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/status.js

@@ -0,0 +1,19 @@
+/**
+ * Viva transaction status letter mapping and plugin status enum.
+ *
+ * Implements plan P17: maps Viva's raw `StatusId` letter codes to the
+ * plugin's canonical `VivaTransactionStatus` enum. The M-family letters
+ * (M, MA, MI, ML, MS, MW) all map to `'disputed'` with the specific
+ * letter stored in `claim_substate`.
+ *
+ * Implements plan A9: adds `authorized → cancelled` transition
+ * (void-before-capture).
+ *
+ * The actual runtime `mapStatusLetter` function lives in S4
+ * (src/webhooks/status-lattice.ts). This file is types only.
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:398
+ * @see references/viva-docs/md/wh-sale-transactions.txt:210
+ */
+export {};
+//# sourceMappingURL=status.js.map

package/dist/types/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/types/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}