> For the complete documentation index, see [llms.txt](https://help.checkoutchamp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.checkoutchamp.com/crm/gateway-setup/gateway-integrations/square-payments/square-payments-v2-checkout-champ-builder-set-up.md).

# Square Payments V2 (Checkout Champ builder set-up)

{% hint style="info" %}
**Disclaimers:**

CheckoutChamp **does not** store any card details for merchants using Square's Payment Gateway.

Square will work for one-time and recurring purchases.

Using Square on your checkout will force all of your offers and upsells to run against your Square gateway.
{% endhint %}

* [How to Obtain Square Credentials](#squarepaymentsv2-checkoutchampbuilderset-up-howtoobtainsquarecredentials)
* [Gateway Setup](#squarepaymentsv2-checkoutchampbuilderset-up-gatewaysetup)
* [Checkout Page Setup](#squarepaymentsv2-checkoutchampbuilderset-up-checkoutpagesetup)
* [Upsell Page Setup](#squarepaymentsv2-checkoutchampbuilderset-up-upsellpagesetup)

***

### **How to Obtain Square Credentials** <a href="#squarepaymentsv2-checkoutchampbuilderset-up-howtoobtainsquarecredentials" id="squarepaymentsv2-checkoutchampbuilderset-up-howtoobtainsquarecredentials"></a>

**Step 1.** Go [here ](https://squareup.com/us/en/developers)and login to the Square Developer Dashboard using your Square credentials

**Step 2.** Once logged into the Developer Dashboard click **New Application**

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FeG4VeS8gP0ayDPgc6a1h%2FUntitled.png?alt=media&amp;token=4c894194-fdbc-4c5a-b1d3-b04558ee0cc7" alt=""><figcaption></figcaption></figure>

**Step 3. Name** and **Create** your Application, Doing so gives you complete API access for your Square merchant account.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FM9FwNxlMIaK7M4IVquVV%2FUntitled.png?alt=media&amp;token=0665398f-a8df-424a-b270-79724cc314ad" alt="" width="563"><figcaption></figcaption></figure>

**Step 4** Once you have created your Application, Navigate to the **Credentials** Section.&#x20;

&#x20;       **Step 4a: Make sure to turn Sandbox Mode OFF.**

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FIqn8e6mBbFaV1hRobwoE%2FUntitled.png?alt=media&amp;token=fdaab362-4d68-40a9-ad8b-bc8dce9fb708" alt=""><figcaption></figcaption></figure>

**Step 5.** Once you have turned off Sandbox Mode you will be able to access your **Application Id**

**Reference:** [Get Started](https://developer.squareup.com/docs/get-started)

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FBoSke1D7e2E1XvxjOdiC%2FUntitled.png?alt=media&amp;token=9360c777-ac43-4c6a-a502-f3a336b2737c" alt=""><figcaption></figcaption></figure>

**Step 6.** Navigate to the Locations Section to uncover your **LocationId**

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FPwUeKYy3bKLz2Auj5uHr%2FUntitled.png?alt=media&amp;token=c7ccf222-dd18-4537-aaa4-bc2dc11d6d5b" alt=""><figcaption></figcaption></figure>

### &#x20;**Gateway Setup** <a href="#squarepaymentsv2-checkoutchampbuilderset-up-gatewaysetup" id="squarepaymentsv2-checkoutchampbuilderset-up-gatewaysetup"></a>

**Step 1**. Go to your funnel **Settings** >**Payments**

**Step 2**. Go to the **Square Gateway**

**Step 3**. If you have previously setup your Square gateway, then select it

**Step 4**. To add your Square gateway, press the  button. Enter a Title and then your **ApplicationID**, **AccessToken,** and **LocationId**.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FXkJJVFPjWCmbdzbUmIK9%2FUntitled.png?alt=media&amp;token=97645d83-cef8-4fb0-84d5-2ce4ce3dd31b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2Fr54PDg5YaMhRSyyLUsgO%2FUntitled.png?alt=media&amp;token=0fe2b197-d14e-4023-9678-1216475847f0" alt=""><figcaption></figcaption></figure>

**Step 5**. Save the gateway setup

**Step 6**. Enter your **Application ID** and **Location ID** again below the **Square Gateway**

**Step 7**. Press **Save & Continue**<br>

### **Checkout Page Setup** <a href="#squarepaymentsv2-checkoutchampbuilderset-up-checkoutpagesetup" id="squarepaymentsv2-checkoutchampbuilderset-up-checkoutpagesetup"></a>

**Step 1**. Edit your checkout page

**Step 2**. Remove any card number, expiration date, and cvv elements from the page

**Step 3**. Go to **Open Blocks > Forms**

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FsyJ5aPUK1xdxl1rYJeDs%2FUntitled.png?alt=media&amp;token=d019085d-cb62-43bc-a786-659159f171e5" alt=""><figcaption></figcaption></figure>

**Step 4**. Drag the **Square Checkout** element onto the page in the spot where the card information was removed

**Step 5**. Your checkout page should have a Square element on the page similar to this. When the live page loads this element will be replaced by Square card elements.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FgfrYUx2r8nxCdlPfFsLT%2FUntitled.png?alt=media&amp;token=9758fb10-19a3-4e25-8226-d3220bf6239a" alt=""><figcaption></figcaption></figure>

**Step 6**. Verify your checkout button is configured correctly. There is no special configuration needed for Square.

**Step 7**. Save your checkout page

**Step 8**. Exit the page builder

**Step 9**. Publish

### **Upsell Page Setup** <a href="#squarepaymentsv2-checkoutchampbuilderset-up-upsellpagesetup" id="squarepaymentsv2-checkoutchampbuilderset-up-upsellpagesetup"></a>

Upsells work automatically with Square as the payment source on checkout pages. No additional work is required.<br>
