Getting Started in Sandbox

This document will guide you through the steps to setup your Sandbox account.

Step 2 - Ask your onboarding contact at Zepto to enable PayTo on your new Sandbox account

To enable the PayTo APIs on your account, we just need to know your test account details. After your Sandbox account has been set up, let your onboarding buddy know via email or phone the following info:

• Your Legal Entity or Business Name; and
• Account nickname

Once we've activated your sandbox test account, you should be able to move on to the next step.

Step 3 - Setup your Sandbox OAuth application

Once your account is confirmed as up and running, sign in and create an OAuth2 profile for your application:

1. Once you're logged into your Zepto account, click on your name at the top left of the interface
2. In the drop-down menu displayed click on ‘Your applications’
3. Click on the green ‘+ New application’ button
4. Fill in the necessary fields

• When defining the available scope of your application, ensure you have the following PayTo specific actions configured:
  • pay_to_agreements
  • pay_to_aliases
  • pay_to_amendments
  • pay_to_amendment_recalls
  • pay_to_cancellations
  • pay_to_payments
  • pay_to_reactivations
  • pay_to_suspensions
• You can copy and paste everything from the Scopes box to ensure that your application has full access to our API.

5. Select the green ‘Submit’ button when complete

📘

Click here for additional OAuth guides.

Step 4 - Setup a Personal Access Token

Your personal access token can be generated from your Zepto User Interface. Personal access tokens don't expire but can be deleted and replaced anytime.

Follow these steps to create your personal access token

1. Click ‘Your applications’ from your account profile dropdown
2. Select the application created in Step 3
3. Click ‘+Personal Access Token’
4. Enter a relevant title (eg. “Zepto Sandbox Access Token”)
5. Copy the personal access token into a secure document

• NOTE: The access token will be masked once the pop-up modal is closed

Step 5 - Setup Webhooks

Due to the asynchronous nature of our PayTo API, you'll need a way to stay up to date with any updates to your Agreements and Payments. The primary method for staying up to date is by subscribing to our Webhook notifications, but polling is also supported.

If you choose to use webhooks you will first need to configure them in your Zepto Account Settings page.

Configure a Webhook URL

1. Once you're logged into your Zepto account, click on your name at the top left of the interface
2. In the drop-down menu displayed click on ‘Webhooks’
3. Click on the green ‘+Webhook’ button
4. Add the URL to be called and select the relevant PayTo events
5. Click ‘Add webhook’

Step 6 - Start throwing some sand

You should now have access to our PayTo APIs via the tool of your choice!

👍

Happy Testing !!