@delopay/sdk 0.76.0 → 0.77.0

package/dist/index.d.cts

@@ -187,6 +187,26 @@ interface PaymentCreateRequest {
     browser_info?: Record<string, unknown> | null;
     /** Set to `true` to generate a hosted payment link for this payment. */
     payment_link?: boolean | null;
+    /**
+     * Whether this is a test payment. The environment belongs to the payment, not to
+     * the processor.
+     *
+     * - `true` — run against the processor's sandbox and record the transaction as a
+     *   test, keeping it out of live transaction lists and analytics. A processor with
+     *   no sandbox credentials stored is called with the only credentials it has, so a
+     *   live-only processor will charge for real.
+     * - `false` — run live, even if the processor still carries the deprecated
+     *   account-level test-mode toggle.
+     * - omit — the processor's toggle decides, as it did before this field existed.
+     *
+     * Create-only: `confirm` and `update` can be called from the browser with a client
+     * secret, so the environment is fixed when you create the payment on your server.
+     *
+     * Requires a DeloPay backend that knows this field. The payments API rejects
+     * unknown fields, so sending it to an older deployment fails the whole create
+     * with `IR_06` rather than ignoring it.
+     */
+    test_mode?: boolean | null;
 }
 interface PaymentUpdateRequest {
     amount?: number | null;
@@ -349,9 +369,10 @@ interface PaymentResponse {
     /** Bank statement descriptor (suffix portion). */
     statement_descriptor_suffix?: string | null;
     /**
-     * Whether this payment ran in test mode (against a sandbox/test connector).
-     * Set at confirm from the connector account's test mode; `null` for payments
-     * created but never confirmed against a connector.
+     * Which environment this payment ran in. Reflects the `test_mode` you sent at
+     * create; when you sent nothing it is filled in from the processor's own toggle
+     * once a processor is picked, and stays `null` for a payment that never reached
+     * one. `null` counts as live everywhere it is filtered on.
      */
     test_mode?: boolean | null;
     [key: string]: unknown;
@@ -3958,6 +3979,17 @@ declare class Payments {
      *   { headers: { 'Idempotency-Key': 'order_1001' } },
      * );
      * ```
+     *
+     * @example Send `test_mode` to pick the environment per payment, so a staging
+     * deploy cannot charge real cards and a forgotten processor toggle cannot
+     * swallow production traffic:
+     * ```typescript
+     * const payment = await delopay.payments.create({
+     *   amount: 5000,
+     *   currency: 'EUR',
+     *   test_mode: process.env.NODE_ENV !== 'production',
+     * });
+     * ```
      */
     create(params: PaymentCreateRequest, options?: RequestExtras): Promise<PaymentResponse>;
     /**

package/dist/index.d.ts

@@ -187,6 +187,26 @@ interface PaymentCreateRequest {
     browser_info?: Record<string, unknown> | null;
     /** Set to `true` to generate a hosted payment link for this payment. */
     payment_link?: boolean | null;
+    /**
+     * Whether this is a test payment. The environment belongs to the payment, not to
+     * the processor.
+     *
+     * - `true` — run against the processor's sandbox and record the transaction as a
+     *   test, keeping it out of live transaction lists and analytics. A processor with
+     *   no sandbox credentials stored is called with the only credentials it has, so a
+     *   live-only processor will charge for real.
+     * - `false` — run live, even if the processor still carries the deprecated
+     *   account-level test-mode toggle.
+     * - omit — the processor's toggle decides, as it did before this field existed.
+     *
+     * Create-only: `confirm` and `update` can be called from the browser with a client
+     * secret, so the environment is fixed when you create the payment on your server.
+     *
+     * Requires a DeloPay backend that knows this field. The payments API rejects
+     * unknown fields, so sending it to an older deployment fails the whole create
+     * with `IR_06` rather than ignoring it.
+     */
+    test_mode?: boolean | null;
 }
 interface PaymentUpdateRequest {
     amount?: number | null;
@@ -349,9 +369,10 @@ interface PaymentResponse {
     /** Bank statement descriptor (suffix portion). */
     statement_descriptor_suffix?: string | null;
     /**
-     * Whether this payment ran in test mode (against a sandbox/test connector).
-     * Set at confirm from the connector account's test mode; `null` for payments
-     * created but never confirmed against a connector.
+     * Which environment this payment ran in. Reflects the `test_mode` you sent at
+     * create; when you sent nothing it is filled in from the processor's own toggle
+     * once a processor is picked, and stays `null` for a payment that never reached
+     * one. `null` counts as live everywhere it is filtered on.
      */
     test_mode?: boolean | null;
     [key: string]: unknown;
@@ -3958,6 +3979,17 @@ declare class Payments {
      *   { headers: { 'Idempotency-Key': 'order_1001' } },
      * );
      * ```
+     *
+     * @example Send `test_mode` to pick the environment per payment, so a staging
+     * deploy cannot charge real cards and a forgotten processor toggle cannot
+     * swallow production traffic:
+     * ```typescript
+     * const payment = await delopay.payments.create({
+     *   amount: 5000,
+     *   currency: 'EUR',
+     *   test_mode: process.env.NODE_ENV !== 'production',
+     * });
+     * ```
      */
     create(params: PaymentCreateRequest, options?: RequestExtras): Promise<PaymentResponse>;
     /**

package/dist/index.js

@@ -74,7 +74,7 @@ import {
   surfacePadValue,
   verticalGapValue,
   visibleCustomFields
-} from "./chunk-D7DPAKI2.js";
+} from "./chunk-RODMYISN.js";
 export {
   ALL_CUSTOM_FIELD_CONDITION_SOURCES,
   ALL_CUSTOM_FIELD_OPERATORS,

package/dist/internal.cjs

@@ -1281,6 +1281,17 @@ var Payments = class {
    *   { headers: { 'Idempotency-Key': 'order_1001' } },
    * );
    * ```
+   *
+   * @example Send `test_mode` to pick the environment per payment, so a staging
+   * deploy cannot charge real cards and a forgotten processor toggle cannot
+   * swallow production traffic:
+   * ```typescript
+   * const payment = await delopay.payments.create({
+   *   amount: 5000,
+   *   currency: 'EUR',
+   *   test_mode: process.env.NODE_ENV !== 'production',
+   * });
+   * ```
    */
   async create(params, options) {
     return this.request("POST", "/payments", { body: params, ...options });