The following documentation details how to sign up for a sandbox account and test your integration in sandbox mode. Production Merchant Dashboard follows a similar process, only with real data and validation.Documentation Index
Fetch the complete documentation index at: https://docs.sezzle.com/llms.txt
Use this file to discover all available pages before exploring further.
Sandbox Dashboard
Before going live, you may test your integration with Sezzle using the Sezzle sandbox test environment, rather than the live production environment. Merchants can create a standalone sandbox account without a production account, ideal for testing production features without becoming a Sezzle merchant (e.g., during system integration)New User Sign Up
- Go to Sezzle Sandbox Dashboard Merchant Sign Up
- Enter
Email addressandPassword(save credentials for later) - Enter
Phone number- Any valid phone number. We will not send OTPs to this number in Sandbox, but we do validate that it is a valid number.
- Set up Passkey (Optional if phone number is based in US/CA)
Submitting a Merchant Application
- Click
Startto proceed to the Merchant Application - Enter your
First NameandLast Name- This will update your user information. You will be set as the primary contact for this merchant application, but this can be changed later.
- Complete the rest of the form, then click
Submit - Once inside the Merchant Dashboard, complete steps 1-2 (
Personal InformationandBusiness Information) of the Merchant Checklist then clickSubmit for Approval- None of the information in these sections needs to be real or accurate for Sandbox application
- Contact your account manager or Sezzle Support for application approval. We only review sandbox applications upon request.
- Unless otherwise requested, sandbox accounts will be approved with default settings. Please let us know if you need to test with any specific customizations enabled.
- Once your application has been approved, you will receive a notification at the email address provided.
Existing User Sign In
Once your application has been approved, Log in to the Sandbox Dashboard. Some key features are highlighted below:Main Menu
- Orders can be viewed once you begin testing
- Settlements and Transaction Data can be downloaded once you begin testing, or use the
Download Databutton in the menu - Setup Checklist
Add Sezzle as a payment option at your checkoutlinks to the appropriate documentation for the Ecommerce Type specified in your application- In Production environment,
Connect a Credit or Debit Card to verify identityandLink a Bank Accountsteps must also be completed before API keys can be generated, but this is not required for Sandbox. Add Sezzle to your product and cart pages: Sezzle Dynamic Widgets can be tested in your sandbox store, but they always connect to Sezzle’s production environment with your production Merchant ID and require configuration.
- In Production environment,
Settings
- API Keys can now be generated and retrieved (Admin users only)
- Payment Methods can be added to the account with Test Data to issue refunds
- Manage Users by inviting team members
- Custom email domains may need to be allow-listed. Contact Sezzle Support if you encounter an error message.
- Invitations expire within 24 hours. Contact Sezzle Support if an invitation needs to be re-sent.
- Add Another Store
- A merchant user can only have one application pending at a time.
Testing Your Integration
Setting Up the Payment Option
- Complete the
Add Sezzle as a payment option at your checkoutstep of the Setup Checklist - In your app or SDK configuration, enable “sandbox” or “test” mode (the documentation for your environment will give more specific instructions)
- Enter your sandbox API Keys in the appropriate field
- API keys are not transferrable across environments. This value will need to be updated when switching to production / live mode.
- Place item(s) in your cart and select Sezzle as the payment method
- If you are redirected to the Sezzle checkout, the integration is connected successfully
- If you do not see Sezzle as an option:
- Try adjusting your cart total, between
$20-$2500 - Ensure you have a US or CA IP address, or are connected to a VPN
Sezzle is only available within the US and CA. The shopper account may be linked to a foreign phone number with Passkey, but the ability to check out will depend on location. - Try adjusting your cart total, between
Completing the Sezzle Checkout
- Complete the shopper sign up or sign in
- This login is distinct from your merchant account, but you can use the same details (save credentials for later)
- As with merchant account, information can be fake except for email address. OTP will always be 123123
- See Test Data for more test values
- Once you finalize the order, you should be redirected back to the merchant site’s confirmation page
- You can now review the order details in your ecommerce dashboard and the Sezzle Dashboard and perform any follow-up actions - capture, release or refund
Installment Options and Spending Power
The installment options seen by the shopper at checkout may vary based on a combination of these factors:- Merchant options configuration - Each installment type enabled for the merchant has a min and max range
- Shopper’s available Sezzle spending power - Based on soft credit check and/or Sezzle payment history, minus outstanding balance
- Current order total
- Set app to Authorize Only
- Optional: Set Authorization Expiration Period to 30 minutes
- Keep test transactions as small as possible
- Select Pay in Full at checkout
- Shopper can add bank account to pay off outstanding loans
- Merchant can release/refund test orders as they are placed (will need bank account for the latter, and/or switch to
Delayed Settlementpayout option in MDash) - Request Sezzle Admin to increase spending power manually on tester’s shopper account
Refer to Postman Setup section on how to programmatically create orders and more leveraging Sezzle Core API.