API Documentation

Founded in 2025, KashyBee Global FZ-LLC, licensed under Ras Al Khaimah Economic Zone (RAKEZ), was established with a vision to transform the way businesses and consumers engage in digital transactions. In an era where payment and transaction complexities often limit growth, KashyBee introduces an innovative, voucher-based payment ecosystem that combines simplicity, security, and flexibility.

As a digital payment solutions company, KashyBee specializes in automated, voucher-driven collection systems designed to power seamless transactions across industries such as gaming, trading, ride-hailing, food delivery, and travel. The platform enables merchants to accept payments effortlessly while reducing operational costs and improving approval rates. For consumers, KashyBee offers a secure, cardless, and traceable way to make online purchases using easy-to-redeem digital vouchers.

Built on a foundation of innovation, transparency, and reliability, KashyBee continues to expand its global footprint, empowering both merchants and consumers to transact confidently in today's digital economy.

At KashyBee, our mission is to simplify, secure, and modernize digital payment through voucher-first, developer-friendly solutions. We aim to empower both businesses and consumers to transact seamlessly across borders, platforms, and industries, without compromising security or convenience.

KashyBee operates through a dual business model that caters to both enterprises and individual users.

The B2B division focuses on payment orchestration through voucher-based systems, accessible via secure APIs and intuitive merchant dashboards. This allows businesses to automate voucher issuance, redemption tracking, and payout reconciliation within their existing platforms.

Simultaneously, the B2C division provides a direct-to-consumer platform that enables individuals to purchase, store, and redeem vouchers easily for online and in-app transactions, making cashless payments accessible to a wider audience.

KashyBee's technology ecosystem delivers a complete set of payment tools designed for adaptability and scale:

• Voucher Generation: One-time and reusable vouchers that can be redeemed online or through mobile applications.
• Unified API: A single interface to issue vouchers, track redemptions, and reconcile payouts.
• Real-Time Notifications: Webhooks for instant updates on settlements, redemptions, and risk signals.
• Advanced Configuration: Support for multiple currencies, voucher limits, expiry controls, and usage rules.
• Consumer Access: A user-friendly portal for individuals to manage and redeem vouchers securely.

KashyBee stands out through a combination of technological innovation and operational transparency:

• Frictionless, cardless payments through secure voucher links or codes.
• Fully programmable voucher parameters, amount, currency, expiry, and redemption conditions.
• Real-time reporting and reconciliation for operational clarity.
• A unified ecosystem serving both B2B and B2C segments.
• Strong compliance infrastructure including KYB/KYC onboarding and audit-ready monitoring.

KashyBee's products and services are designed for a broad range of sectors within the digital economy, including:

• Online marketplaces and e-commerce platforms (such as travel, retail, and food delivery)
• Gaming and digital entertainment industries
• Subscription-based platforms
• Fintech companies managing controlled payout and collection flows
• Individual consumers seeking secure, flexible, and cardless online payment methods

Security and compliance are integral to KashyBee's operations. The company adheres to international best practices and regulatory frameworks to ensure trust and transparency at every transaction stage.

Additionally, KYB/KYC verification processes and risk-based voucher issuance policies maintain the integrity of the KashyBee ecosystem and safeguard both merchants and end-users.

Base URL

All endpoints are relative to the base URL. Generate your API Key from your Kashybee Panel → Settings → API Keys.

POST /transactions/add-funds

This endpoint is responsible to add amount into your user's wallet and your currency panel on https://kashybee.io .

Parameters

Request Body

Example Usage

curl -X POST "https://api.kashybee.io/transactions/add-funds" \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "voucherCode": "KB_2025_10_ABCDEFGH12345678",
    "amount": 150,
    "walletCurrency": "USD"
  }'

import axios from "axios";

const API_URL = "https://api.kashybee.io/transactions/add-funds";
const API_KEY = "<YOUR_API_KEY>";

async function addFunds() {
  try {
    const response = await axios.post(
      API_URL,
      {
        voucherCode: "KB_2025_10_ABCDEFGH12345678",
        amount: 150,
        walletCurrency: "USD",
      },
      {
        headers: {
          x-api-key: API_KEY,
          "Content-Type": "application/json",
        },
      }
    );
    console.log("Funds Added Successfully:", response.data);
  } catch (error) {
    console.error("Error Adding Funds:", error.message);
  }
}

addFunds();

Example Response

{
  "success": true,
  "message": "Voucher redeemed successfully",
  "data": {
    "amountDeposited": 100,
    "currency": "USD",
    "transactionId": "TXN_2025_10_ABCDEFGH12345678",
    "createdAt": "2025-10-30T05:38:37.004Z"
  }
}

{
  "success": false,
  "message": "Api Key is invalid",
  "statusCode": 401
}

{
  "success": false,
  "message": "Api Key is revoked",
  "statusCode": 401
}

{
  "success": false,
  "message": "Invalid voucher code",
  "statusCode": 400
}

{
  "success": false,
  "message": "Only NEW or PENDING vouchers can be redeemed",
  "statusCode": 400
}

{
  "success": false,
  "message": "Voucher issued in a different currency",
  "statusCode": 403
}

{
  "success": false,
  "message": "Insufficient voucher balance. Max available: 100",
  "statusCode": 403
}

{
  "success": false,
  "message": "Merchant not found",
  "statusCode": 404
}

{
  "success": false,
  "message": "Merchant wallet not found on Kashybee",
  "statusCode": 404
}

Notes

• API key must be included in request headers.
• If amount is not provided, the entire voucher balance will be redeemed.
• The walletCurrency must be a valid ISO 4217 currency code (e.g., USD, PHP, INR).

POST /transactions/withdraw-funds

This endpoint is responsible to withdraw amount from your user's wallet and your currency panel on https://kashybee.io .

Parameters

Request Body

Example Usage

curl -X POST "https://api.kashybee.io/transactions/withdraw-funds" \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "country": "US",
    "userId": "f1c6e1b3-12d4-4a2c-8b0b-d98ac84b3a1f",
    "amount": 100,
    "walletCurrency": "USD"
  }'

import axios from "axios";

const API_URL = "https://api.kashybee.io/transactions/withdraw-funds";
const API_KEY = "<YOUR_API_KEY>";

async function withdrawFunds() {
  try {
    const response = await axios.post(
      API_URL,
      {
        email: "user@example.com",
        country: "US",
        userId: "f1c6e1b3-12d4-4a2c-8b0b-d98ac84b3a1f",
        amount: 100,
        walletCurrency: "USD",
      },
      {
        headers: {
          x-api-key: API_KEY,
          "Content-Type": "application/json",
        },
      }
    );
    console.log("Withdrawal Successful:", response.data);
  } catch (error) {
    console.error("Error Withdrawing Funds:", error.message);
  }
}

withdrawFunds();

Example Response

{
  "success": true,
  "message": "Funds withdrawn successfully",
  "data": {
    "amountWithdrawn": 100,
    "currency": "USD",
    "transactionId": "TXN_2025_10_ABCDEFGH12345678",
    "createdAt": "2025-10-30T05:38:37.004Z"
  }
}

{
  "success": false,
  "message": "Api Key is invalid",
  "statusCode": 401
}

{
  "success": false,
  "message": "Api Key is revoked",
  "statusCode": 401
}

{
  "success": false,
  "message": "Merchant not found",
  "statusCode": 404
}

{
  "success": false,
  "message": "Merchant wallet not found on Kashybee",
  "statusCode": 404
}

{
  "success": false,
  "message": "Insufficient funds in merchant wallet to process the transaction",
  "statusCode": 403
}

Notes

• API key must be included in request headers.
• If a valid email address isn't provided, voucher code delivery to email will fail.
• The walletCurrency must be a valid ISO 4217 currency code (e.g., USD, PHP, INR).