From 94de21e7f24ffaf06897e3f9d7f97e03a9c98bb0 Mon Sep 17 00:00:00 2001
From: Elizabeth Kenyon <elizabeth.kenyon@shopify.com>
Date: Wed, 22 Nov 2023 09:08:08 -0600
Subject: [PATCH] Add explanation of the isTest Field

Also add the returnURL field to docs
---
 .changeset/happy-lobsters-draw.md                     |  2 ++
 .../src/server/authenticate/admin/billing/types.ts    | 11 +++++++++++
 2 files changed, 13 insertions(+)
 create mode 100644 .changeset/happy-lobsters-draw.md

diff --git a/.changeset/happy-lobsters-draw.md b/.changeset/happy-lobsters-draw.md
new file mode 100644
index 0000000000..a845151cc8
--- /dev/null
+++ b/.changeset/happy-lobsters-draw.md
@@ -0,0 +1,2 @@
+---
+---
diff --git a/packages/shopify-app-remix/src/server/authenticate/admin/billing/types.ts b/packages/shopify-app-remix/src/server/authenticate/admin/billing/types.ts
index 47bdeec40d..6d61b6817e 100644
--- a/packages/shopify-app-remix/src/server/authenticate/admin/billing/types.ts
+++ b/packages/shopify-app-remix/src/server/authenticate/admin/billing/types.ts
@@ -25,6 +25,14 @@ export interface RequestBillingOptions<Config extends AppConfigArg>
    * The plan to request. Must be one of the values defined in the `billing` config option.
    */
   plan: keyof Config['billing'];
+  /**
+   * Whether to use the test mode. This prevents the credit card from being charged. Test shops and demo shops cannot be charged.
+   */
+  isTest?: boolean;
+  /**
+   * The URL to return to after the merchant approves the payment.
+   */
+  returnUrl?: string;
 }
 
 export interface CancelBillingOptions {
@@ -38,6 +46,9 @@ export interface CancelBillingOptions {
    * {@link https://shopify.dev/docs/apps/billing/subscriptions/cancel-recurring-charges}
    */
   prorate?: boolean;
+  /*
+   * Whether to use the test mode. This prevents the credit card from being charged. Test shops and demo shops cannot be charged.
+   */
   isTest?: boolean;
 }