@waffo/pancake-ts 0.8.0 → 0.9.0

package/dist/index.d.cts

@@ -720,6 +720,8 @@ interface CreateCheckoutSessionParams {
     darkMode?: boolean;
     /** Custom metadata */
     metadata?: Record<string, string>;
+    /** Order-side business identifier (max 128 chars); inherited by orders, payments, refunds */
+    orderMerchantExternalId?: string;
 }
 /** Result of creating a checkout session. */
 interface CheckoutSessionResult {
@@ -781,6 +783,8 @@ interface CreateRefundTicketParams {
     requestedAmount: RequestedAmount;
     /** Custom metadata */
     metadata?: Record<string, unknown>;
+    /** Refund-ticket business-side identifier (max 128 chars); inherited by the executed refund on PSP success */
+    refundTicketMerchantExternalId?: string;
 }
 /** Parameters for resubmitting a rejected refund ticket (buyer-side). */
 interface ResubmitRefundTicketParams {
@@ -821,6 +825,8 @@ interface RefundTicket {
     executedAt: string | null;
     /** Custom metadata */
     metadata: Record<string, unknown>;
+    /** Refund-ticket business-side identifier (max 128 chars, immutable across resubmits) */
+    refundTicketMerchantExternalId: string | null;
     /** Current version number */
     versionNumber: number | null;
     /** Current (latest) version data */
@@ -954,6 +960,10 @@ interface WebhookEventData {
     buyerEmail: string;
     /** Merchant-provided buyer identity from checkout session */
     merchantProvidedBuyerIdentity?: string;
+    /** Order business identifier; present on order/payment + refund events (inherited from order) */
+    orderMerchantExternalId?: string;
+    /** Refund-ticket business identifier; only present on refund.* events */
+    refundTicketMerchantExternalId?: string;
     currency: string;
     /** Billing/shipping address (structured object) */
     billingDetail?: Record<string, unknown>;
@@ -1244,6 +1254,7 @@ declare class BuyerSession {
      *   paymentId: "PAY_xxx",
      *   reason: "Product not as described",
      *   requestedAmount: { amount: "29.00", currency: "USD" },
+     *   refundTicketMerchantExternalId: "REF-2026-00891",
      * });
      */
     createRefundTicket(params: CreateRefundTicketParams): Promise<{
@@ -1313,12 +1324,13 @@ declare class CheckoutAnonymousResource {
      * });
      *
      * @example
-     * // Pre-fill email and billing without issuing a session token
+     * // Pre-fill email + billing + attach business-side order reference
      * const result = await client.checkout.anonymous.create({
      *   productId: "PROD_xxx",
      *   currency: "USD",
      *   buyerEmail: "customer@example.com",
      *   billingDetail: { country: "US", isBusiness: false, postcode: "10001" },
+     *   orderMerchantExternalId: "ORDER-2026-00891",
      * });
      */
     create(params: AnonymousCheckoutParams): Promise<CheckoutSessionResult & {
@@ -1356,6 +1368,7 @@ declare class CheckoutAuthenticatedResource {
      *   currency: "USD",
      *   buyerIdentity: "user-123",
      *   buyerEmail: "customer@example.com",
+     *   orderMerchantExternalId: "ORDER-2026-00891",
      * });
      * // Redirect to result.checkoutUrl (includes #token=...)
      */

package/dist/index.d.ts

@@ -720,6 +720,8 @@ interface CreateCheckoutSessionParams {
     darkMode?: boolean;
     /** Custom metadata */
     metadata?: Record<string, string>;
+    /** Order-side business identifier (max 128 chars); inherited by orders, payments, refunds */
+    orderMerchantExternalId?: string;
 }
 /** Result of creating a checkout session. */
 interface CheckoutSessionResult {
@@ -781,6 +783,8 @@ interface CreateRefundTicketParams {
     requestedAmount: RequestedAmount;
     /** Custom metadata */
     metadata?: Record<string, unknown>;
+    /** Refund-ticket business-side identifier (max 128 chars); inherited by the executed refund on PSP success */
+    refundTicketMerchantExternalId?: string;
 }
 /** Parameters for resubmitting a rejected refund ticket (buyer-side). */
 interface ResubmitRefundTicketParams {
@@ -821,6 +825,8 @@ interface RefundTicket {
     executedAt: string | null;
     /** Custom metadata */
     metadata: Record<string, unknown>;
+    /** Refund-ticket business-side identifier (max 128 chars, immutable across resubmits) */
+    refundTicketMerchantExternalId: string | null;
     /** Current version number */
     versionNumber: number | null;
     /** Current (latest) version data */
@@ -954,6 +960,10 @@ interface WebhookEventData {
     buyerEmail: string;
     /** Merchant-provided buyer identity from checkout session */
     merchantProvidedBuyerIdentity?: string;
+    /** Order business identifier; present on order/payment + refund events (inherited from order) */
+    orderMerchantExternalId?: string;
+    /** Refund-ticket business identifier; only present on refund.* events */
+    refundTicketMerchantExternalId?: string;
     currency: string;
     /** Billing/shipping address (structured object) */
     billingDetail?: Record<string, unknown>;
@@ -1244,6 +1254,7 @@ declare class BuyerSession {
      *   paymentId: "PAY_xxx",
      *   reason: "Product not as described",
      *   requestedAmount: { amount: "29.00", currency: "USD" },
+     *   refundTicketMerchantExternalId: "REF-2026-00891",
      * });
      */
     createRefundTicket(params: CreateRefundTicketParams): Promise<{
@@ -1313,12 +1324,13 @@ declare class CheckoutAnonymousResource {
      * });
      *
      * @example
-     * // Pre-fill email and billing without issuing a session token
+     * // Pre-fill email + billing + attach business-side order reference
      * const result = await client.checkout.anonymous.create({
      *   productId: "PROD_xxx",
      *   currency: "USD",
      *   buyerEmail: "customer@example.com",
      *   billingDetail: { country: "US", isBusiness: false, postcode: "10001" },
+     *   orderMerchantExternalId: "ORDER-2026-00891",
      * });
      */
     create(params: AnonymousCheckoutParams): Promise<CheckoutSessionResult & {
@@ -1356,6 +1368,7 @@ declare class CheckoutAuthenticatedResource {
      *   currency: "USD",
      *   buyerIdentity: "user-123",
      *   buyerEmail: "customer@example.com",
+     *   orderMerchantExternalId: "ORDER-2026-00891",
      * });
      * // Redirect to result.checkoutUrl (includes #token=...)
      */

package/dist/index.js

@@ -271,6 +271,11 @@ function validateEnum(field, value, allowed) {
     fail(`Invalid ${field}: expected one of [${allowed.join(", ")}], got "${value}"`);
   }
 }
+function validateMaxLength(field, value, max) {
+  if (value !== void 0 && value.length > max) {
+    fail(`${field} must be at most ${max} characters, got ${value.length}`);
+  }
+}
 function validatePositiveInteger(field, value) {
   if (!Number.isInteger(value) || value <= 0) {
     fail(`Invalid ${field}: expected positive integer, got ${value}`);
@@ -313,6 +318,7 @@ function validateCheckoutCommon(params) {
   if (params.expiresInSeconds !== void 0) {
     validatePositiveInteger("expiresInSeconds", params.expiresInSeconds);
   }
+  validateMaxLength("orderMerchantExternalId", params.orderMerchantExternalId, 128);
 }
 
 // src/resources/auth.ts
@@ -415,6 +421,7 @@ var BuyerSession = class {
    *   paymentId: "PAY_xxx",
    *   reason: "Product not as described",
    *   requestedAmount: { amount: "29.00", currency: "USD" },
+   *   refundTicketMerchantExternalId: "REF-2026-00891",
    * });
    */
   async createRefundTicket(params) {
@@ -422,6 +429,7 @@ var BuyerSession = class {
     validateRequired("reason", params.reason);
     validateAmountString("requestedAmount.amount", params.requestedAmount.amount);
     validateCurrencyCode("requestedAmount.currency", params.requestedAmount.currency);
+    validateMaxLength("refundTicketMerchantExternalId", params.refundTicketMerchantExternalId, 128);
     return unwrapAction(await this.http.post("/v1/actions/refund-ticket/create-ticket", params));
   }
   /**
@@ -488,12 +496,13 @@ var CheckoutAnonymousResource = class {
    * });
    *
    * @example
-   * // Pre-fill email and billing without issuing a session token
+   * // Pre-fill email + billing + attach business-side order reference
    * const result = await client.checkout.anonymous.create({
    *   productId: "PROD_xxx",
    *   currency: "USD",
    *   buyerEmail: "customer@example.com",
    *   billingDetail: { country: "US", isBusiness: false, postcode: "10001" },
+   *   orderMerchantExternalId: "ORDER-2026-00891",
    * });
    */
   async create(params) {
@@ -529,6 +538,7 @@ var CheckoutAuthenticatedResource = class {
    *   currency: "USD",
    *   buyerIdentity: "user-123",
    *   buyerEmail: "customer@example.com",
+   *   orderMerchantExternalId: "ORDER-2026-00891",
    * });
    * // Redirect to result.checkoutUrl (includes #token=...)
    */