@proxy-checkout/server-js 0.0.4-pr-76.34.1 → 0.0.4-prx-88.37.1

package/README.md

@@ -41,6 +41,9 @@ const handoff = await proxy.sessions.createHandoff({
     items: [{ product_id: "prod_123", quantity: 1 }],
   },
   idempotencyKey: "order_123",
+  // Optional: omit in normal production flows to use the dashboard default.
+  // Preview/staging/multi-origin environments may override the merchant payer page.
+  payerDestinationUrl: "https://preview.example.com/checkout",
 });
 
 console.log(handoff.handoffUrl);
@@ -79,6 +82,14 @@ if (event.type === "subscription.renewed") {
 Production calls default to `https://api.proxycheckout.com`. Tests, local
 development, and previews can pass `apiHost`.
 
+Configure a production/default payer destination and allowed hosts in the Proxy
+dashboard. `payerDestinationUrl` is optional. Most production integrations can
+omit it and use the dashboard default. Preview, staging, or multi-origin
+environments may pass `payerDestinationUrl` to `sessions.createHandoff(...)`;
+Proxy validates the host against the configured allowed hosts, stores the
+destination on the handoff session, and forwards the payer there when the hosted
+handoff opens.
+
 ## First Publish Decisions
 
 The first public package versions are intentionally `0.0.x` because the SDK API is

package/dist/cjs/sessions.d.cts

@@ -18,6 +18,7 @@ export interface CreateProxySessionInput extends CreateProxySessionOptions {
     };
 }
 export interface CreateProxySessionHandoffInput extends CreateProxySessionInput {
+    readonly payerDestinationUrl?: string;
     readonly payHost?: string;
     readonly publishableKey?: string;
 }

package/dist/cjs/sessions.d.ts

@@ -18,6 +18,7 @@ export interface CreateProxySessionInput extends CreateProxySessionOptions {
     };
 }
 export interface CreateProxySessionHandoffInput extends CreateProxySessionInput {
+    readonly payerDestinationUrl?: string;
     readonly payHost?: string;
     readonly publishableKey?: string;
 }

package/dist/cjs/sessions.js

@@ -68,6 +68,9 @@ class ProxySessionsResource {
         }
         const response = await this.httpClient.request("POST", "/proxy_sessions/handoff", {
             ...toCreateProxySessionBody(input),
+            ...(input.payerDestinationUrl !== undefined
+                ? { payer_destination_url: input.payerDestinationUrl }
+                : {}),
             publishable_key: publishableKey,
         }, {
             idempotencyKey: input.idempotencyKey,

package/dist/cjs/version.d.cts

@@ -1,3 +1,3 @@
 export declare const proxyCheckoutServerSdkName = "@proxy-checkout/server-js";
-export declare const proxyCheckoutServerSdkVersion = "0.0.4-pr-76.34.1";
-export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.4-pr-76.34.1";
+export declare const proxyCheckoutServerSdkVersion = "0.0.4-prx-88.37.1";
+export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.4-prx-88.37.1";

package/dist/cjs/version.d.ts

@@ -1,3 +1,3 @@
 export declare const proxyCheckoutServerSdkName = "@proxy-checkout/server-js";
-export declare const proxyCheckoutServerSdkVersion = "0.0.4-pr-76.34.1";
-export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.4-pr-76.34.1";
+export declare const proxyCheckoutServerSdkVersion = "0.0.4-prx-88.37.1";
+export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.4-prx-88.37.1";

package/dist/cjs/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.proxyCheckoutServerSdkUserAgent = exports.proxyCheckoutServerSdkVersion = exports.proxyCheckoutServerSdkName = void 0;
 exports.proxyCheckoutServerSdkName = "@proxy-checkout/server-js";
-exports.proxyCheckoutServerSdkVersion = "0.0.4-pr-76.34.1";
+exports.proxyCheckoutServerSdkVersion = "0.0.4-prx-88.37.1";
 exports.proxyCheckoutServerSdkUserAgent = `${exports.proxyCheckoutServerSdkName}/${exports.proxyCheckoutServerSdkVersion}`;

package/dist/esm/sessions.d.ts

@@ -18,6 +18,7 @@ export interface CreateProxySessionInput extends CreateProxySessionOptions {
     };
 }
 export interface CreateProxySessionHandoffInput extends CreateProxySessionInput {
+    readonly payerDestinationUrl?: string;
     readonly payHost?: string;
     readonly publishableKey?: string;
 }

package/dist/esm/sessions.js

@@ -65,6 +65,9 @@ export class ProxySessionsResource {
         }
         const response = await this.httpClient.request("POST", "/proxy_sessions/handoff", {
             ...toCreateProxySessionBody(input),
+            ...(input.payerDestinationUrl !== undefined
+                ? { payer_destination_url: input.payerDestinationUrl }
+                : {}),
             publishable_key: publishableKey,
         }, {
             idempotencyKey: input.idempotencyKey,

package/dist/esm/version.d.ts

@@ -1,3 +1,3 @@
 export declare const proxyCheckoutServerSdkName = "@proxy-checkout/server-js";
-export declare const proxyCheckoutServerSdkVersion = "0.0.4-pr-76.34.1";
-export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.4-pr-76.34.1";
+export declare const proxyCheckoutServerSdkVersion = "0.0.4-prx-88.37.1";
+export declare const proxyCheckoutServerSdkUserAgent = "@proxy-checkout/server-js/0.0.4-prx-88.37.1";

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 export const proxyCheckoutServerSdkName = "@proxy-checkout/server-js";
-export const proxyCheckoutServerSdkVersion = "0.0.4-pr-76.34.1";
+export const proxyCheckoutServerSdkVersion = "0.0.4-prx-88.37.1";
 export const proxyCheckoutServerSdkUserAgent = `${proxyCheckoutServerSdkName}/${proxyCheckoutServerSdkVersion}`;

package/package.json

@@ -7,7 +7,7 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/esm/index.d.ts",
-  "version": "0.0.4-pr-76.34.1",
+  "version": "0.0.4-prx-88.37.1",
   "devDependencies": {
     "@types/node": "^24.12.4",
     "@vitest/coverage-v8": "4.1.7",