@delopay/sdk 0.272.0 → 0.274.0

package/dist/index.d.cts

@@ -269,10 +269,12 @@ interface PaymentCreateRequest {
     /** URL to leave an unpaid hosted checkout; never falls back to `return_url`. */
     cancel_url?: string | null;
     /**
-     * How long the client secret / hosted checkout link stays usable, in
-     * seconds from creation. Omit to inherit the shop's default
-     * (`business_profile.session_expiry`, itself defaulting to 15 minutes).
-     * The backend rejects values outside its accepted window with a 400.
+     * How long the client secret stays usable, in seconds from creation. Omit to
+     * inherit the shop's default (`business_profile.session_expiry`, itself
+     * defaulting to 15 minutes). With `payment_link: true` it is also how long
+     * the checkout link stays payable; omitted, the link follows the shop's
+     * link expiry, else 48 hours. The backend rejects values outside its
+     * accepted window with a 400.
      */
     session_expiry?: number | null;
     /** Descriptor shown on the customer's bank statement (name portion). */
@@ -11386,6 +11388,16 @@ interface CheckoutMethodItem {
      * `merchant_connector_id`.
      */
     smart_routing?: boolean | null;
+    /**
+     * e-Payouts' Pay with card (`ppal:paypal_direct_form`) only: hold it back as
+     * a fallback for the shop's other card forms. Absent or `true`: the checkout
+     * draws it only while no other card form is drawn for the payment (no other
+     * card account, every one past its cap or drawn away by the split, or the
+     * card form could not be prepared at its processor). `false`: it is drawn
+     * beside another card form too. Only on an item whose available entry
+     * `supports_card_fallback`.
+     */
+    card_fallback?: boolean | null;
     /**
      * `general` only: the method it stands for, the `capability` of an entry
      * in {@link CheckoutMethodsResponse.general} (`wallet.paypal`).
@@ -11747,7 +11759,11 @@ interface AvailableCheckoutMethod {
     default_icon_svg?: string | null;
     /** Original provider artwork. Render as an image, never inline. */
     default_icon_image?: string | null;
-    /** May sit in the express strip (draws the wallet's own button). */
+    /**
+     * May sit in the express strip: the method draws its own button, a wallet's,
+     * or PayPal's button and card fields on e-Payouts' PayPal Express and Pay
+     * with card panes.
+     */
     supports_native_element: boolean;
     /** Follows a redirect when tapped, so `open_in` applies. */
     supports_open_target: boolean;
@@ -11809,6 +11825,11 @@ interface AvailableCheckoutMethod {
      * deployment that lets the render choose the account drawing it.
      */
     supports_smart_routing?: boolean | null;
+    /**
+     * The item may set `card_fallback`: e-Payouts' Pay with card, a card form of
+     * its own that the checkout holds back while another card form is drawn.
+     */
+    supports_card_fallback?: boolean | null;
     /** The processor's own limits on the method, where it states them. */
     provider_limits?: CheckoutMethodProviderLimits | null;
 }
@@ -16923,7 +16944,9 @@ interface PaneCapability {
      * Whether this method can be drawn as the wallet's own button instead of a
      * DeloPay tile — i.e. whether {@link Pane.nativeElement} means anything
      * here. The router's answer, not the dashboard's: Apple Pay and Google Pay
-     * on Stripe's wallet rail and on Airwallex's hosted-element rail today.
+     * on Stripe's wallet rail and on Airwallex's hosted-element rail, and
+     * e-Payouts' PayPal Express and Pay with card panes, which draw PayPal's
+     * button and card fields.
      *
      * Optional because a router predating the field omits it; read absent as
      * `false`, so the control is offered nowhere rather than on a method the
@@ -18409,8 +18432,14 @@ type BuyerCaseCategory = 'refund_request' | 'inquiry' | 'dispute' | 'bank_charge
 type BuyerCaseOrigin = 'buyer_portal' | 'payment_provider' | 'bank_card_issuer' | 'unknown';
 /** Where the case stands. */
 type BuyerCaseState = 'waiting_for_merchant' | 'approved' | 'refund_pending' | 'refunded' | 'refund_failed' | 'declined' | 'open' | 'under_review' | 'resolved' | 'cancelled' | 'expired' | 'unknown';
-/** Who acts next on a case, or who acted in an event. `provider` is the payment provider or, for a bank chargeback, the card issuer. */
-type BuyerCaseActor = 'buyer' | 'merchant' | 'provider' | 'nobody' | 'unknown';
+/**
+ * Who acts next on a case, or who acted in an event. `provider` is the payment
+ * provider or, for a bank chargeback, the card issuer. `reviewer` is the
+ * reviewers of the buyer's evidence: DeloPay's, or the shop's team where it
+ * reviews the evidence. A case that is not closed names `reviewer` while a
+ * submission waits, and `buyer` while their evidence is asked for.
+ */
+type BuyerCaseActor = 'buyer' | 'merchant' | 'provider' | 'reviewer' | 'nobody' | 'unknown';
 /** In whose favour a case was decided. `pending` until decided; `unknown` when no decision was reported. */
 type BuyerCaseOutcome = 'pending' | 'buyer_favour' | 'merchant_favour' | 'cancelled' | 'unknown';
 /** Where the refund that answers a request stands at the payment provider. */
@@ -18425,8 +18454,25 @@ interface BuyerCaseRefund {
     /** When the refund's current status was recorded. */
     updated_at: string;
 }
-/** What happened in a case. `status_changed` names the state reached; `stage_changed` and `deadline_changed` are a dispute moving on with the payment provider or card issuer. */
-type BuyerCaseEventKind = 'opened' | 'approved' | 'declined' | 'refund_started' | 'refunded' | 'refund_failed' | 'status_changed' | 'stage_changed' | 'deadline_changed';
+/**
+ * What happened in a case. `status_changed` names the state reached;
+ * `stage_changed` and `deadline_changed` are a dispute moving on with the
+ * payment provider or card issuer. The `evidence_` kinds are steps on the
+ * case's evidence that the buyer sees; they leave the case's state as it is.
+ */
+type BuyerCaseEventKind = 'opened' | 'approved' | 'declined' | 'refund_started' | 'refunded' | 'refund_failed' | 'status_changed' | 'stage_changed' | 'deadline_changed'
+/** The buyer handed in evidence. */
+ | 'evidence_submitted'
+/** The buyer asked for more time to hand in evidence. */
+ | 'evidence_extension_requested'
+/** A reviewer asked the buyer for more information, by the cut-off in `due_at`. */
+ | 'evidence_information_requested'
+/** A reviewer answered the buyer. */
+ | 'evidence_replied'
+/** A reviewer recorded the result of the evidence review, in `evidence_outcome`. */
+ | 'evidence_reviewed'
+/** A reviewer moved the buyer's cut-off for evidence to `due_at`. */
+ | 'evidence_deadline_changed';
 /** How far a dispute has gone with the payment provider or card issuer. */
 type BuyerCaseStage = 'inquiry' | 'dispute' | 'pre_arbitration' | 'arbitration';
 /** One step of a case. */
@@ -18448,6 +18494,10 @@ interface BuyerCaseEvent {
     currency?: string | null;
     /** When DeloPay recorded the step, when it was recorded as it happened. Absent for a step read back from the case itself. */
     recorded_at?: string | null;
+    /** The buyer's cut-off for evidence that this step set. */
+    due_at?: string | null;
+    /** The result of an evidence review. */
+    evidence_outcome?: BuyerEvidenceOutcome | null;
 }
 /** A buyer's case: a refund request or a dispute about one of their purchases, with where it stands, who acts next and what was recorded. */
 interface BuyerCase {
@@ -18775,7 +18825,11 @@ interface BuyerEvidenceNote {
 }
 /** Who wrote a message, or who wrote last in a conversation. */
 type BuyerConversationSide = 'buyer' | 'merchant';
-/** Whether a conversation takes new messages. A closed one keeps its history and takes none until the team reopens it. */
+/**
+ * Whether the team writes in a conversation. A closed one keeps its history and
+ * takes no team message until the team reopens it; the buyer's next message
+ * reopens it too.
+ */
 type BuyerConversationStatus = 'open' | 'closed';
 /** A conversation with a buyer as the shop's team sees it in the inbox. */
 interface BuyerConversationSummary {
@@ -25268,8 +25322,9 @@ declare class BuyerAccount {
      */
     listRecordMessages(record: string, query: BuyerPortalConversationQuery, options?: RequestExtras): Promise<BuyerPortalMessagePage>;
     /**
-     * A message from a confirmed record to one of its shops. Sending again with
-     * the same `client_message_id` returns the message the first send stored.
+     * A message from a confirmed record to one of its shops. A message to a
+     * closed conversation reopens it. Sending again with the same
+     * `client_message_id` returns the message the first send stored.
      */
     sendRecordMessage(record: string, message: BuyerPortalMessageCreate, options?: RequestExtras): Promise<BuyerPortalMessage>;
     /**
@@ -25377,8 +25432,9 @@ declare class BuyerPortal {
      */
     listMessages(query?: BuyerPortalConversationQuery, options?: RequestExtras): Promise<BuyerPortalMessagePage>;
     /**
-     * A message to the shop. Sending again with the same `client_message_id`
-     * returns the message the first send stored; a closed conversation refuses it.
+     * A message to the shop. A message to a closed conversation reopens it.
+     * Sending again with the same `client_message_id` returns the message the
+     * first send stored.
      */
     sendMessage(message: BuyerPortalMessageCreate, options?: RequestExtras): Promise<BuyerPortalMessage>;
     /**
@@ -27818,12 +27874,21 @@ declare class CheckoutSession {
      * channel the backend's locale resolution reads; a `?locale=` query is
      * silently ignored by this route.
      *
+     * `cardOnly` is a direct link to the card form (`payment_method=card`):
+     * when the Stripe card form being prepared is the one the link names, its
+     * PaymentIntent is created for `card` alone. `cardProvider` and
+     * `cardAccount` name that form's connector and account; absent or blank
+     * matches any.
+     *
      * `GET /payment-link/data/{merchantId}/{paymentId}`
      */
     fetchCheckoutData(params?: {
         locale?: string;
         theme?: string;
         country?: string;
+        cardOnly?: boolean;
+        cardProvider?: string;
+        cardAccount?: string;
     }, options?: RequestExtras): Promise<CheckoutDataResponse>;
     /**
      * The subscription twin of {@link CheckoutSession.fetchCheckoutData}: the

package/dist/index.d.ts

@@ -269,10 +269,12 @@ interface PaymentCreateRequest {
     /** URL to leave an unpaid hosted checkout; never falls back to `return_url`. */
     cancel_url?: string | null;
     /**
-     * How long the client secret / hosted checkout link stays usable, in
-     * seconds from creation. Omit to inherit the shop's default
-     * (`business_profile.session_expiry`, itself defaulting to 15 minutes).
-     * The backend rejects values outside its accepted window with a 400.
+     * How long the client secret stays usable, in seconds from creation. Omit to
+     * inherit the shop's default (`business_profile.session_expiry`, itself
+     * defaulting to 15 minutes). With `payment_link: true` it is also how long
+     * the checkout link stays payable; omitted, the link follows the shop's
+     * link expiry, else 48 hours. The backend rejects values outside its
+     * accepted window with a 400.
      */
     session_expiry?: number | null;
     /** Descriptor shown on the customer's bank statement (name portion). */
@@ -11386,6 +11388,16 @@ interface CheckoutMethodItem {
      * `merchant_connector_id`.
      */
     smart_routing?: boolean | null;
+    /**
+     * e-Payouts' Pay with card (`ppal:paypal_direct_form`) only: hold it back as
+     * a fallback for the shop's other card forms. Absent or `true`: the checkout
+     * draws it only while no other card form is drawn for the payment (no other
+     * card account, every one past its cap or drawn away by the split, or the
+     * card form could not be prepared at its processor). `false`: it is drawn
+     * beside another card form too. Only on an item whose available entry
+     * `supports_card_fallback`.
+     */
+    card_fallback?: boolean | null;
     /**
      * `general` only: the method it stands for, the `capability` of an entry
      * in {@link CheckoutMethodsResponse.general} (`wallet.paypal`).
@@ -11747,7 +11759,11 @@ interface AvailableCheckoutMethod {
     default_icon_svg?: string | null;
     /** Original provider artwork. Render as an image, never inline. */
     default_icon_image?: string | null;
-    /** May sit in the express strip (draws the wallet's own button). */
+    /**
+     * May sit in the express strip: the method draws its own button, a wallet's,
+     * or PayPal's button and card fields on e-Payouts' PayPal Express and Pay
+     * with card panes.
+     */
     supports_native_element: boolean;
     /** Follows a redirect when tapped, so `open_in` applies. */
     supports_open_target: boolean;
@@ -11809,6 +11825,11 @@ interface AvailableCheckoutMethod {
      * deployment that lets the render choose the account drawing it.
      */
     supports_smart_routing?: boolean | null;
+    /**
+     * The item may set `card_fallback`: e-Payouts' Pay with card, a card form of
+     * its own that the checkout holds back while another card form is drawn.
+     */
+    supports_card_fallback?: boolean | null;
     /** The processor's own limits on the method, where it states them. */
     provider_limits?: CheckoutMethodProviderLimits | null;
 }
@@ -16923,7 +16944,9 @@ interface PaneCapability {
      * Whether this method can be drawn as the wallet's own button instead of a
      * DeloPay tile — i.e. whether {@link Pane.nativeElement} means anything
      * here. The router's answer, not the dashboard's: Apple Pay and Google Pay
-     * on Stripe's wallet rail and on Airwallex's hosted-element rail today.
+     * on Stripe's wallet rail and on Airwallex's hosted-element rail, and
+     * e-Payouts' PayPal Express and Pay with card panes, which draw PayPal's
+     * button and card fields.
      *
      * Optional because a router predating the field omits it; read absent as
      * `false`, so the control is offered nowhere rather than on a method the
@@ -18409,8 +18432,14 @@ type BuyerCaseCategory = 'refund_request' | 'inquiry' | 'dispute' | 'bank_charge
 type BuyerCaseOrigin = 'buyer_portal' | 'payment_provider' | 'bank_card_issuer' | 'unknown';
 /** Where the case stands. */
 type BuyerCaseState = 'waiting_for_merchant' | 'approved' | 'refund_pending' | 'refunded' | 'refund_failed' | 'declined' | 'open' | 'under_review' | 'resolved' | 'cancelled' | 'expired' | 'unknown';
-/** Who acts next on a case, or who acted in an event. `provider` is the payment provider or, for a bank chargeback, the card issuer. */
-type BuyerCaseActor = 'buyer' | 'merchant' | 'provider' | 'nobody' | 'unknown';
+/**
+ * Who acts next on a case, or who acted in an event. `provider` is the payment
+ * provider or, for a bank chargeback, the card issuer. `reviewer` is the
+ * reviewers of the buyer's evidence: DeloPay's, or the shop's team where it
+ * reviews the evidence. A case that is not closed names `reviewer` while a
+ * submission waits, and `buyer` while their evidence is asked for.
+ */
+type BuyerCaseActor = 'buyer' | 'merchant' | 'provider' | 'reviewer' | 'nobody' | 'unknown';
 /** In whose favour a case was decided. `pending` until decided; `unknown` when no decision was reported. */
 type BuyerCaseOutcome = 'pending' | 'buyer_favour' | 'merchant_favour' | 'cancelled' | 'unknown';
 /** Where the refund that answers a request stands at the payment provider. */
@@ -18425,8 +18454,25 @@ interface BuyerCaseRefund {
     /** When the refund's current status was recorded. */
     updated_at: string;
 }
-/** What happened in a case. `status_changed` names the state reached; `stage_changed` and `deadline_changed` are a dispute moving on with the payment provider or card issuer. */
-type BuyerCaseEventKind = 'opened' | 'approved' | 'declined' | 'refund_started' | 'refunded' | 'refund_failed' | 'status_changed' | 'stage_changed' | 'deadline_changed';
+/**
+ * What happened in a case. `status_changed` names the state reached;
+ * `stage_changed` and `deadline_changed` are a dispute moving on with the
+ * payment provider or card issuer. The `evidence_` kinds are steps on the
+ * case's evidence that the buyer sees; they leave the case's state as it is.
+ */
+type BuyerCaseEventKind = 'opened' | 'approved' | 'declined' | 'refund_started' | 'refunded' | 'refund_failed' | 'status_changed' | 'stage_changed' | 'deadline_changed'
+/** The buyer handed in evidence. */
+ | 'evidence_submitted'
+/** The buyer asked for more time to hand in evidence. */
+ | 'evidence_extension_requested'
+/** A reviewer asked the buyer for more information, by the cut-off in `due_at`. */
+ | 'evidence_information_requested'
+/** A reviewer answered the buyer. */
+ | 'evidence_replied'
+/** A reviewer recorded the result of the evidence review, in `evidence_outcome`. */
+ | 'evidence_reviewed'
+/** A reviewer moved the buyer's cut-off for evidence to `due_at`. */
+ | 'evidence_deadline_changed';
 /** How far a dispute has gone with the payment provider or card issuer. */
 type BuyerCaseStage = 'inquiry' | 'dispute' | 'pre_arbitration' | 'arbitration';
 /** One step of a case. */
@@ -18448,6 +18494,10 @@ interface BuyerCaseEvent {
     currency?: string | null;
     /** When DeloPay recorded the step, when it was recorded as it happened. Absent for a step read back from the case itself. */
     recorded_at?: string | null;
+    /** The buyer's cut-off for evidence that this step set. */
+    due_at?: string | null;
+    /** The result of an evidence review. */
+    evidence_outcome?: BuyerEvidenceOutcome | null;
 }
 /** A buyer's case: a refund request or a dispute about one of their purchases, with where it stands, who acts next and what was recorded. */
 interface BuyerCase {
@@ -18775,7 +18825,11 @@ interface BuyerEvidenceNote {
 }
 /** Who wrote a message, or who wrote last in a conversation. */
 type BuyerConversationSide = 'buyer' | 'merchant';
-/** Whether a conversation takes new messages. A closed one keeps its history and takes none until the team reopens it. */
+/**
+ * Whether the team writes in a conversation. A closed one keeps its history and
+ * takes no team message until the team reopens it; the buyer's next message
+ * reopens it too.
+ */
 type BuyerConversationStatus = 'open' | 'closed';
 /** A conversation with a buyer as the shop's team sees it in the inbox. */
 interface BuyerConversationSummary {
@@ -25268,8 +25322,9 @@ declare class BuyerAccount {
      */
     listRecordMessages(record: string, query: BuyerPortalConversationQuery, options?: RequestExtras): Promise<BuyerPortalMessagePage>;
     /**
-     * A message from a confirmed record to one of its shops. Sending again with
-     * the same `client_message_id` returns the message the first send stored.
+     * A message from a confirmed record to one of its shops. A message to a
+     * closed conversation reopens it. Sending again with the same
+     * `client_message_id` returns the message the first send stored.
      */
     sendRecordMessage(record: string, message: BuyerPortalMessageCreate, options?: RequestExtras): Promise<BuyerPortalMessage>;
     /**
@@ -25377,8 +25432,9 @@ declare class BuyerPortal {
      */
     listMessages(query?: BuyerPortalConversationQuery, options?: RequestExtras): Promise<BuyerPortalMessagePage>;
     /**
-     * A message to the shop. Sending again with the same `client_message_id`
-     * returns the message the first send stored; a closed conversation refuses it.
+     * A message to the shop. A message to a closed conversation reopens it.
+     * Sending again with the same `client_message_id` returns the message the
+     * first send stored.
      */
     sendMessage(message: BuyerPortalMessageCreate, options?: RequestExtras): Promise<BuyerPortalMessage>;
     /**
@@ -27818,12 +27874,21 @@ declare class CheckoutSession {
      * channel the backend's locale resolution reads; a `?locale=` query is
      * silently ignored by this route.
      *
+     * `cardOnly` is a direct link to the card form (`payment_method=card`):
+     * when the Stripe card form being prepared is the one the link names, its
+     * PaymentIntent is created for `card` alone. `cardProvider` and
+     * `cardAccount` name that form's connector and account; absent or blank
+     * matches any.
+     *
      * `GET /payment-link/data/{merchantId}/{paymentId}`
      */
     fetchCheckoutData(params?: {
         locale?: string;
         theme?: string;
         country?: string;
+        cardOnly?: boolean;
+        cardProvider?: string;
+        cardAccount?: string;
     }, options?: RequestExtras): Promise<CheckoutDataResponse>;
     /**
      * The subscription twin of {@link CheckoutSession.fetchCheckoutData}: the

package/dist/index.js

@@ -252,7 +252,7 @@ import {
   visibleCustomFields,
   whopAccentSwatch,
   whopCardElement
-} from "./chunk-42VYNDXJ.js";
+} from "./chunk-R6E57AD4.js";
 export {
   AIRWALLEX_AUTOFILL_TREATMENTS,
   AIRWALLEX_CARD_LAYOUTS,

package/dist/internal.cjs

@@ -7862,8 +7862,9 @@ var BuyerAccount = class {
     });
   }
   /**
-   * A message from a confirmed record to one of its shops. Sending again with
-   * the same `client_message_id` returns the message the first send stored.
+   * A message from a confirmed record to one of its shops. A message to a
+   * closed conversation reopens it. Sending again with the same
+   * `client_message_id` returns the message the first send stored.
    */
   async sendRecordMessage(record, message, options) {
     return this.request("POST", `/buyer-account/records/${encodeURIComponent(record)}/messages`, {
@@ -8090,8 +8091,9 @@ var BuyerPortal = class {
     });
   }
   /**
-   * A message to the shop. Sending again with the same `client_message_id`
-   * returns the message the first send stored; a closed conversation refuses it.
+   * A message to the shop. A message to a closed conversation reopens it.
+   * Sending again with the same `client_message_id` returns the message the
+   * first send stored.
    */
   async sendMessage(message, options) {
     return this.request("POST", "/buyer-portal/messages", { body: message, ...options });
@@ -12809,6 +12811,12 @@ var CheckoutSession = class {
    * channel the backend's locale resolution reads; a `?locale=` query is
    * silently ignored by this route.
    *
+   * `cardOnly` is a direct link to the card form (`payment_method=card`):
+   * when the Stripe card form being prepared is the one the link names, its
+   * PaymentIntent is created for `card` alone. `cardProvider` and
+   * `cardAccount` name that form's connector and account; absent or blank
+   * matches any.
+   *
    * `GET /payment-link/data/{merchantId}/{paymentId}`
    */
   async fetchCheckoutData(params, options) {
@@ -12817,7 +12825,13 @@ var CheckoutSession = class {
       "GET",
       `/payment-link/data/${encodeURIComponent(this.merchantId)}/${encodeURIComponent(this.paymentId)}`,
       {
-        query: { theme: params?.theme, country: country || void 0 },
+        query: {
+          theme: params?.theme,
+          country: country || void 0,
+          card_only: params?.cardOnly || void 0,
+          card_provider: params?.cardOnly ? params.cardProvider?.trim() || void 0 : void 0,
+          card_account: params?.cardOnly ? params.cardAccount?.trim() || void 0 : void 0
+        },
         ...options,
         headers: {
           ...params?.locale ? {
@@ -14927,6 +14941,20 @@ var AdminPortal = class {
       { body: params }
     );
   }
+  /**
+   * Correct the funding type, issuing bank and issuing country recorded on
+   * past card payments from the BIN table, across every merchant, oldest
+   * first, one bounded page per call. Resume with the returned `next_after`
+   * until it is `null`. A dry run, the default, reports without writing; a
+   * payment that changed while the page ran is left alone and counted as a
+   * conflict. Payments of merchants whose attempts are stored in Redis are
+   * not corrected.
+   *
+   * `POST /admin-portal/card-funding/backfill`
+   */
+  async backfillCardFunding(params = {}) {
+    return this.request("POST", "/admin-portal/card-funding/backfill", { body: params });
+  }
 };
 function transactionListQuery(params) {
   if (!params) return void 0;