Getting Started

Getting Started with ZTLment Sandbox Environment

Welcome to ZTLment! Follow these steps to get started with our sandbox environment and make your first payment.

Step 1: Request Access to the Sandbox Environment

If you already have access to the sandbox environment you can skip this step.

To get started with the sandbox API you must have sandbox access. Once your request has been approved, you will receive an email to create your password and proceed to next steps.

Step 2: Download the ZTLment Authenticator App

Next, download the ZTLment Authenticator App and follow these steps to complete your account setup.

• iOS Store.
• Android Store.

To use the app in sandbox mode:

1. Open the app.
2. Press the “settings” button.
3. Select “Sandbox”.

Now you can log in with your email and password. The app will guide you through the final account setup and address generation.

Step 3: Get Your API Key Ready

Once you have access to the sandbox environment, you will receive an email with your unique API key.

• Important: Keep the API key secret. You will use this key as api_key in your HTTPS requests, as detailed in the Authentication section.

Step 4: Create Your First Payment with the Sandbox API

Now that you have sandbox access and your account set up, you can make your first payment. Follow these steps:

1. 🙋‍♀️ Create External Recipients or Create Vendor Accounts

   • Create an ‘External Recipient’ or ‘Vendor Account’ which contains the information of the payee.

2. 💰 Create Payment Objects

   • Create a Payment Object where the payer is the id of either your treasury payment wallet or your split wallet (for more details about the different wallets see here). The payee should be the id of the newly created External Recipient or Vendor Account.

3. ✅ Approve Payment Objects in your Dashboard

   • Once you have created a Payment Object, it must be approved via the dashboard. In production, this is typically done by someone in the finance department.

4. 📲 Sign Payment Objects in ZTLment Authenticator App

   • The final step is to sign the Payment Object with the private key of your wallet, which is securely stored in the ZTLment Authenticator app on the user’s phone.
   • When a new Payment Object has been approved, the app will receive a notification to sign it. To sign, log in to the app and swipe. This action completes the payment process.

By following these steps, you'll be able to successfully navigate our sandbox environment and make your first payment. For further details on each step, refer to the linked sections in the documentation.