Zendit Gateway API – Postman Collection

This repository contains Postman collection and environment files to help you quickly integrate and test against the Zendit Gateway API.

Quick Start Guide

1. Files you received

• postman_collection.json
• postman_environment.json

2. Import into Postman

1. Open Postman.
2. From the top menu: File → Import.
3. First, import the Environment file.
4. Then, import the Collection file.

3. Configure your Environment

1. In the left sidebar, go to Environments.
2. Open Zendit Gateway – SANDBOX.
3. Go to the Variables tab.
4. Replace the stock value of auth_token with your token (e.g., sand_xxx...).
   • Use the token starting with sand_ for integration testing.
   • Use prod_ tokens only in production.
5. Click Save.

4. Select your Environment

1. Go to the Collections tab.
2. Double-click the Zendit Gateway API collection.
3. In the top-right corner, open the Environment dropdown.
4. Select Zendit Gateway – SANDBOX.

5. Start testing

Expand the collection folders to find sample requests:

• Utilities
• Brands
• Topups
• Vouchers
• eSIM
• Bill Pay
• Promos
• Transactions
• Reports

You can send GET or POST requests to test the integration.
Default parameters _limit and _offset are enabled. Other filters (like brand, subType, country) are available but unchecked by default.

6. Shared variables (Transaction ID & ICCID)

The collection uses shared variables to simplify flows:

• transactionId is automatically generated when you create a purchase (Top-up, Voucher, eSIM, Bill Pay).
  To update it, call the corresponding GET-by-ID endpoint:

  • GET /topups/purchases/{{lastTransactionId}} → updates Top-up transactionId
  • GET /vouchers/purchases/{{lastTransactionId}} → updates Voucher transactionId
  • GET /esim/purchases/{{lastTransactionId}} → updates both transactionId and iccid

• iccid is used only for eSIM endpoints:

  • It is captured automatically from GET eSIM Purchase by ID.
  • After that, it can be reused in:
    • GET /esim/{{iccid}}/plans
    • POST /esim/purchases (bundle purchase)

---