Skip to main content
The Sezzle team has prepared a public Postman collection so merchants can quickly create customers (Sezzle users), sessions, and orders for sandbox testing.

​
Download and Install Postman

  1. Go to postman.com/downloads
  2. Click Download the App
  3. When the installation file has finished downloading, click the file to install the application
  4. Follow installation prompts on the screen

​
Add Sezzle Gateway Collection

When installation is complete, follow these steps to add the Sezzle Gateway collection to Postman.
  1. Download the Postman collection
  2. In the Web page that opens, select your operating system
  3. Click Open Postman if prompted
  4. In Postman, the Sezzle Gateway collection is now displayed in the Collections tab

​
Edit environment variables

The collection is prepared with SezzleGatewayURL, SezzlePrivateAPIKey, and SezzlePublicAPIKey saved to the collection variables. However, it is recommended to save these as Environment variables instead so you can easily toggle between Sandbox and Production, and to keep API keys secret.
  1. In the left toolbar, click Environments
  2. If you have never used Environment variables before, click the + icon and name the new environment Sandbox
  3. Create the new variables as follows:
    VariableTypeInitial value
    SezzleGatewayURLdefaulthttps://sandbox.gateway.sezzle.com
    SezzlePrivateAPIKeysecretsz_pr…
    SezzlePublicAPIKeysecretsz_pub…
  4. Next, copy your API Keys from the Sezzle Sandbox Dashboard into Postman.
    1. To access your credentials, log in to the Sezzle Sandbox Dashboard
    2. Go to Settings > API Keys - your sandbox credentials are here
    3. In Postman, paste your credentials into CURRENT VALUE
      • Do this for both SezzlePublicAPIKey and SezzlePrivateAPIKey
  5. Repeat for Environment Production, with SezzleGatewayURL as https://gateway.sezzle.com and API keys from Sezzle Production Dashboard
API Keys do not translate across environments, i.e. Production API Keys will not work in Sandbox testing.
Only one environment’s dashboard session can be active in the browser 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.
  1. In the left toolbar, click Collections
  2. Click Sezzle Gateway. On the Variables tab, delete the variables we just created in Environments
The other predefined collection variables will be automatically assigned values by the applicable responses and applied to subsequent requests.

​
Using the collection

  1. In the upper-right corner of Postman, select the desired environment (i.e. Sandbox)
  2. Open the applicable folder for your API version (default V2)
  3. Refer to the below diagrams for request sequencing
V2 Gateway Request Flow
  1. Once a session is created, you must visit the checkout_url in the response and complete the checkout before testing most other Orders endpoints.
    • Log in at sandbox.dashboard.sezzle.com/customer
    • The customer account does not need to match the customer details given in the session payload
    • The phone number for the customer account must be real, but other personal information can be fake
    • OTP will be 123123