Digitwave Transaction Engine API Documentation

Welcome to Digitwave Services API Gateway Documentation

Production Version 1.5.3 • Active Service

New? or

API Authentication Setup

All transaction operations inside our engine require an active administrative cryptographic verification token passing token called apikey. This unique string acts as an identity key. It completely eliminates the need for messy browser cookies, allowing native scripts, web apps, and Android mobile apps to execute transactions securely.

Global Production Base URL

https://digitwave-services.com/api/

Global Validation Variable Mapping

Parameter Name	Data Type	Description
apikey	string required	Your platform validation signature token key. Must be included inside the top layer of all incoming payload JSON body arrays or URL strings.

Global JSON Authentication Signature

{
  "apikey": "YTrarsfn7309Ys805"
}

Send Money Request Gateway

Base URL

POST https://digitwave-services.com/api/

End Point

send

Deducts a specified payment amount from the sender's core active ledger balance. This API engine automatically determines if configuration rules should not apply a Percentage charge or a Fixed Amount flat fee.

All fractional figures past the decimal point are immediately cast to integers and truncated to guarantee accurate, whole-number ledger deductions across transactions.

JSON Request Body Schema

Parameter	Type	Description
apikey	string required	Your platform validation key signature token string.
country	string required	The Beneficiary destination country. eg. Republic Of Congo. See the supported countries
carrier	string required	Supported operator name eg. Airtel CG. See the supported carriers
number	string required	Beneficiary mobile number without country code in supported country & carrier. eg. 0618324342
amount	number required	The transfer request amount value. Decimals are securely discarded (e.g., 40.18 becomes 40).

Example Send Money Request Body

{
  "apikey": "YTrarsfn7309Ys8075",
  "country": "Republic of Congo",
  "carrier": "Airtel CG",
  "number": "061234567",
  "amount": 40
}

Response (200 OK - Success)

{
  "success": true,
  "message": "Request accepted, processing in progress",
  "amount": 40,
  "fee_charged": 2,
  "total": 42,
  "remaining_balance": 12408
  "request_id": "A reference Id for this request"
}

Response (400 - request not accepted)

{
  "success": false,
  "message": "Insufficient fund/Balance."
}

Withdrawal Settlement Gate

Base URL

POST https://digitwave-services.com/api/

Endpoint Path

withdrawal

Initiates a secure asset liquidation settlement withdrawal from the wallet. This interface queries your server ENUM attributes, isolates whether processing metrics follow a Percentage or Fixed Amount, and evaluates user balances.

If funds cover both the withdrawal principal amount and the backend calculated fee, the transaction drops its decimal parameters and processes immediately.

JSON Withdrawal Request Body Schema

Parameter	Type	Description
apikey	string required	Your platform validation key signature token string.
country	string required	The Beneficiary destination country. eg. Republic Of Congo. See the supported countries
carrier	string required	Supported operator name eg. Airtel CG. See the supported carriers
number	string required	Beneficiary mobile number without country code in supported country & carrier. eg. 0618324342
amount	number required	The transfer request amount value. Decimals are securely discarded (e.g., 40.18 becomes 40).

Example Withdrawal Request Body

{
  "apikey": "YTrarsfn7309Ys8075",
  "country": "Republic of Congo",
  "carrier": "Airtel CG",
  "number": "061234567",
  "amount": 70
}

Response (200 OK - Settlement Finalized)

{
  "success": true,
  "message": "Request accepted, processing in progress",
  "amount": 70,
  "fee_charged": 5,
  "total": 75,
  "remaining_balance": 5238
  "request_id": "A reference Id for this request"
}

Get Single Request Record

Endpoint Path

GET get_request

Queries the platform transactions table safely using our high-speed, secure parameter-bound execution layers. This retrieves the full parameters and status log of an individual payment request using its unique database row tracking ID.

URL GET Parameters Mapping

Parameter	Type	Description
apikey	string required	Your unique account identification security token signature.
request_id	string required	The precise primary database identifier tracking ID for the transaction record row.

Example GET Request URL Query Mapping

get_request?apikey=xg7749CT83By05cM76&request_id=10v42

Response (200 OK - Record Found)

{
  "success": true,
  "data": {
    {
    "apikey": 65GE59hyr453,
    "request_id": 10W6v42,
    "country": Republic of Congo,
    "carrier": Airtel CG,
    "number": 061234567,
    "amount": 55,
    "fee_charged": 0,
    "total": 55,
    "status": "Success",
    "timestamp_ms": 1774983050123 // Epoch milliseconds.
    "transaction_sms": Transaction Message,
  }  
 }
}

Get List of Requests

Endpoint Path

GET get_requests

Extracts a fully structured, reverse-chronological array index listing of all historical money transactions linked to the profile. This query applies explicit integer casting rules and returns the data newest-first for rapid developer mapping loops.

URL Query Parameters

Parameter	Type	Description
apikey	string required	Your unique account identification security token signature used to safely scope results.
last_request_id	string optional	The last request ID in the previous history list.
order	string optional, default: order=ASC, options are [ASC, DESC]	Arrange list elements from newest to oldest or vise versa.
limit	number optional, default: limit=25, MAX=1000	The last request ID in the previous history list.

Example URL Query Mapping

get_requests?apikey=xg7749CT83By05cM76&last_request_id=65GE59hyr453&order=DESC&limit=50

Response (200 OK - Array Output Payload)

{
  "success": true,
  "total_records": 2,
  "data": [
    {
    "apikey": 65GE59hyr453,
    "request_id": 10v42,
    "country": Republic of Congo,
    "carrier": Airtel CG,
    "number": 061234567,
    "amount": 55,
    "fee_charged": 0,
    "total": 55,
    "status": "Success",
    "timestamp_ms": 1774983050123 // Epoch milliseconds.
    "transaction_sms": Transaction Message,
  },
    {
    "apikey": 65GE59hyr453,
    "request_id": 10v457EW2,
    "country": Republic of Congo,
    "carrier": Airtel CG,
    "number": 061234567,
    "amount": 55,
    "fee_charged": 0,
    "total": 55,
    "status": "Success",
    "timestamp_ms": 1774983057963 // Epoch milliseconds.
    "transaction_sms": Transaction Message,
  }
  ]
}

Supported Countries & Carriers

Transaction processing is strictly limited to our active global networks. Every Send and Withdrawal Request payloads must explicitly pass a matching country and carrier values selected exactly from this static registry table.

Republic of Congo

Supported Carrier Values

MTN CI
RESEAU CHARISMATIQUE

Tanzania

Supported Carrier Values

Airtel

Testing with Postman

To rapidly test your payload configurations without writing scripts, you can utilize the Postman client application. Ensure you configure your settings exactly as shown:

1. Set your HTTP request method type dropdown modifier to POST.
2. Enter your global endpoint address destination URL.
3. Under the Headers panel layout, confirm that your Content-Type variable matches application/json.
4. In the Body tab section layout configuration, select raw, pick JSON, and map out your JSON input parameters.

Postman Interface Setup Blueprint

POST https://digitwave-services.com/api/send

{
  "apikey": "7SAuy698305",
  "country": "Republic of Congo",
  "carrier": "Airtel CG"
  "number": "061234567"
  "amount": 500,
}

Postman API Integration Request Blueprint

Live Interface Map View