Skip to main content

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.

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.
Sandbox and Production credentials are distinct. You will need to complete user sign-up and merchant application in each applicable environment.Only one environment’s dashboard session can be active at a time. If a user is logged in to production then logs in to sandbox on another tab, the production session will end, and vice versa.

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)
Sandbox OTP is always 123123, for both phone and email. We never send notifications for these in sandbox.

New User Sign Up

  1. Go to Sezzle Sandbox Dashboard Merchant Sign Up
  2. Enter Email address and Password (save credentials for later)
  3. 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.
  4. Set up Passkey (Optional if phone number is based in US/CA)

Submitting a Merchant Application

  1. Click Start to proceed to the Merchant Application
  2. Enter your First Name and Last 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.
  3. Complete the rest of the form, then click Submit
  4. Once inside the Merchant Dashboard, complete steps 1-2 (Personal Information and Business Information) of the Merchant Checklist then click Submit for Approval
    • None of the information in these sections needs to be real or accurate for Sandbox application
  5. 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.
  6. 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:
  • Orders can be viewed once you begin testing
  • Settlements and Transaction Data can be downloaded once you begin testing, or use the Download Data button in the menu
  • Setup Checklist Add Sezzle as a payment option at your checkout links to the appropriate documentation for the Ecommerce Type specified in your application
    • In Production environment, Connect a Credit or Debit Card to verify identity and Link a Bank Account steps 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.

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

  1. Complete the Add Sezzle as a payment option at your checkout step of the Setup Checklist
  2. In your app or SDK configuration, enable “sandbox” or “test” mode (the documentation for your environment will give more specific instructions)
  3. 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.
  4. 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.

Completing the Sezzle Checkout

  1. 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
  2. Once you finalize the order, you should be redirected back to the merchant site’s confirmation page
    If trying to perform a test transaction in production, BE CAREFUL when completing the Sezzle checkout, as you will be charged. You can identify the Sezzle environment by observing if “sandbox” is included in the Sezzle checkout URL.
  3. 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
To ensure spending power does not block testing:
  • Set app to Authorize Only
  • 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 Settlement payout 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.