Skip to main content
    Developers
    Get the App

    API documentation, ID Card

    Resell ID card
    vouchers.

    Buy Gambian ID card vouchers from your own platform and hand each customer a voucher and serial number to present at the registration office.

    The Waychit ID Card API lets merchants, agents, and platforms sell National ID card payment vouchers in The Gambia. Amounts are in GMD and your wallet is debited by amount plus fee minus discount.

    Get your API keys Payment API documentation

    Base URL

    https://api.waychit.com

    Currency

    All amounts are in GMD.

    Wallet debit

    amount + fee - discount

    Endpoints at a glance

    http
    GET  /v1/balance
GET  /v1/id-card/services
POST /v1/id-card/purchases
GET  /v1/id-card/purchases/:id
GET  /v1/id-card/purchases?clientReference=

    Authentication

    Every request is authenticated with your merchant API key over HTTPS.

    http
    Authorization: Bearer <api_key>

    Important: Call this API from your own servers only. Never expose the key in client-side code.

    API Endpoints

    GET/v1/id-card/services

    List the ID card services you can sell, with the government fee, the Waychit fee, and any discount applied to your account.

    bash
    curl --location 'https://api.waychit.com/v1/id-card/services' \
--header 'Authorization: Bearer {{api_key}}' \
--header 'Accept: application/json'

    Response

    json
    {
  "success": true,
  "message": "ID card services fetched successfully.",
  "discount": 0,
  "data": [
    {
      "id": "64f...",
      "amount": 450,
      "fee": 15,
      "serviceCode": "NID-STD",
      "serviceName": "National ID Card"
    }
  ]
}

    Returned attributes

    KeyTypeDescription
    idStringService identifier to pass as serviceId when purchasing.
    amountNumberGovernment fee for the service, in GMD.
    feeNumberWaychit service fee, in GMD.
    serviceCodeStringShort code for the service, for example NID-STD.
    serviceNameStringHuman readable service name.
    discountNumberTop level field. Discount in GMD applied to your purchases.

    Purchase Statuses

    pending

    Your wallet was debited and issuance is in progress.

    succeeded

    Vouchers were issued and are present in items.

    refunded

    Issuance failed and your wallet was credited back.

    Error Handling

    401

    Missing or invalid API key.

    400

    Insufficient balance, invalid service, duplicate clientReference, or issuance failed.

    404

    Purchase not found.

    Changelog

    2026-08-24

    • Purchase no longer accepts or returns quantity. Every purchase issues one voucher.

    2026-08-23

    • Purchase data now includes discount, the amount in GMD applied to the purchase.

    2026-08-21

    • Purchase now requires customer: { name, phoneNumber }.

    Get started

    Sell ID card
    vouchers.

    Get your API keys, fund your wallet, and start issuing vouchers to your customers.

    Get API keys