Beta Release
This is pre-release documentation for an API in public beta and is subject to change.
LOYALTY API: WALKTHROUGH 1

Step 1: Set up a Loyalty Program

Step 1.1: Prepare Permalink Get a link to this section

To prepare for the walkthrough, you:

  • Review Sandbox testing considerations. Understand how you test the walkthrough in the Square Sandbox.

  • Gather account information. You need your Sandbox credentials (access token) and location ID. You use the access token to authenticate requests and your location ID when you create an order using the Orders API.

  • Set up the Square loyalty program. Using the Seller Dashboard, you set up the loyalty program.

Step 1.1.1: Square Sandbox testing considerations Permalink Get a link to this section

You test the sample walkthrough in the Square Sandbox environment. After creating a loyalty program, you need a phone number to set up a loyalty account. In the Sandbox, you provide a Sandbox phone number, instead of a real phone number, using the following format:

+1<valid-area-code>555<any-four-digits>

For example, +14255551111. For more information and other Sandbox values, see Sandbox Test Values.

Step 1.1.2: Gather account information Permalink Get a link to this section

Follow these steps to gather account information for your Sandbox environment:

  1. Sign in to the Developer Dashboard.

  2. Open an application, which provides you with the credentials you use. If you do not have an application, you might need to create one.

  3. Get Sandbox credentials:

    1. You can toggle between the Sandbox and Production account. Choose Sandbox.

    2. On the Credentials page, copy the token from Sandbox Access Token.

  4. Get a location ID:

    1. Choose Locations in the left navigation.

    2. On the Locations page, choose an ID from Location ID.

Step 1.2: Set up a loyalty program Permalink Get a link to this section

Use the following steps to open the Seller Dashboard in the Sandbox. The steps are provided if you are setting a loyalty program for the first time. If you have an existing program, modify the program to set the earning points rule and reward tiers as explained.

  1. Open the Seller Dashboard in the Sandbox.

    1. Sign in to the Developer Dashboard.

    2. In the Sandbox Test Accounts section, choose Open for Default Test Account. This opens the Seller Dashboard where you create your loyalty program.

  2. Create a loyalty program.

    1. If this is your first time setting up a loyalty program, an introductory Loyalty Program page opens. Choose Get Started on the page. Otherwise, choose Loyalty in the left navigation, and then choose Settings. walk-through-1-first-time

      You now follow a series of steps to set up a loyalty program.

    2. On the Loyalty Program: Earning Points page, in the Earning Points dialog box, set the following values to create an "Earn 1 Point for every $1 spent" rule, and then choose Continue. walk-through-1-earn-points

    3. On the Loyalty Program: Earning Points page, choose Next.

    4. On the Loyalty Program: Redeeming Rewards step, choose Create a New Reward.

    5. In the New Reward dialog box, set the following values to create a "10% off entire sale" reward, and then choose Create Reward. walk-through-1-new-reward

    6. On the Loyalty Program: Redeeming Rewards step, choose Next.

    7. On the Loyalty Program: Review Program page, review the information, and then choose Next.

    8. On the Loyalty Program: Start Free Trial page, choose Start Free Trial. This opens the Subscribe to Square Loyalty dialog box.

    9. In the dialog box, provide the following fake credit card number that Square provides for the Sandbox environment.
      walk-through-1-subscribe For more information about these sandbox values, see Sandbox Test Values.

    10. On the Loyalty Program page, choose Continue to Overview.

You have now created and subscribed to the Square loyalty program. On the Loyalty Program page in the Seller Dashboard, choose Settings to review the loyalty program you created. This is where you can edit the program, if needed.

Previous

< Loyalty Walkthrough 1

Next

Enroll a Buyer >