Guides

Less-Technical Introduction

I. CONCEPTUAL OVERVIEW

This section explains the "How" and "Why" behind the Prestmit API integration.

1. The Infrastructure: Base URLs & Environments

The API is the bridge between your app/website and the Prestmit operating engine. It operates in two distinct worlds:

  • Sandbox (The Practice Field)
    Base URL: https://dev.prestmit.io/api/partners/v1
    Used for building and testing without real money.

  • Production (The Live Market)
    Base URL: https://prestmit.io/api/partners/v1
    Used for real trades and real profits.

Important Note:
These URLs are for system-to-system communication. Opening them in a browser will return an error because they require API keys and specific requests.

2. The Profit Strategy

By integrating this API, you become a Partner, not just a user.

  • Buying Low (Sell API)
    Users sell gift cards to you.
    You set your own rate.
    Prestmit pays you market rate + partner commission.

  • Selling High (Buy API)
    You buy gift cards at wholesale partner rates.
    You resell at your own retail price.

  • Automation (Webhooks)
    Transactions run 24/7 automatically without manual approval.

3. Security Protocols

  • IP Whitelisting
    Only approved servers can access the system.

  • HMAC Encryption
    Every request is signed to prevent tampering.

II. THE GLOSSARY (TERMS & DEFINITIONS)

🔑 Authentication & Access

  • Base URL — Primary API address
  • API Key — Your public identifier
  • API Secret — Private signing key (never sent directly)
  • Bearer Token — Format used to send API key securely

⚙️ System Environments

  • Sandbox — Test environment (no real money)
  • Production — Live environment (real transactions)
  • Endpoint — Specific API route (e.g. /sell/create)
  • Payload — JSON data sent in requests

⚙️ System Mechanics

  • Webhooks — Instant server notifications for events
  • JSON — Data format used in communication
  • Rate Syncing — Updating prices automatically

📊 Trading & Transactions

  • Category / Sub-Category ID — Identifies card types
  • Physical Card — Image-based card (higher rates)
  • E-code — Digital code (faster, lower rates)
  • Denomination — Card value (e.g. $50, $100)
  • Rate — Current buy/sell price

Statuses:

  • Pending — Processing
  • Success / Completed — Finished
  • Rejected — Failed (invalid/used card or failed withdrawal)

💰 Wallet & Financials

  • Fiat Wallet — Stores NGN or GHS
  • Markup — Your profit margin
  • Withdrawal Endpoint — Sends money to bank
  • Partner Commission — Bonus from Prestmit

III. FAQs

Q: Why did I get an error opening the sandbox URL?
A: It’s not a webpage. It only works with API requests.

Q: Can I control my profit?
A: Yes. Adjust your markup on your backend.

Q: Is there a trade limit?
A: No. The API supports high volume.

Q: What happens if a card is rejected?
A: A webhook sends the reason, and your system informs the user.

Q: How do we go live?
A: After testing in sandbox, request production access.

Q: Do I need real BVN in sandbox?
A: No. You can use:22222222222

Q: Do GET requests have payloads?
A: No. Nothing to hash.

Q: What is a 429 error?
A: Too many requests.

Fix:

  • Reduce request frequency
  • Add delays between calls

Updated 21 days ago