MFS API Documentation

Send and receive money via Mobile Financial Services

API Endpoints

1. Check Active MFS List
POST https://rasi.top/api/mfs.php?action=check
Content-Type: application/x-www-form-urlencoded
2. Submit Transaction (Cash-in / Cash-out)
POST https://rasi.top/api/mfs.php?action=submit
Content-Type: application/x-www-form-urlencoded
3. Check Transaction Status
POST https://rasi.top/api/mfs.php?action=status
Content-Type: application/x-www-form-urlencoded

Required Parameters

Parameter Type Description Example
api_keystringYour API keyXXXAPIKEY
api_secretstringYour API secretXXXSECRETKEY
actionstringAPI action: check, submit, or statuscheck
mfs_idintegerMFS account ID (required for submit)1
amountfloatTransaction amount (required for submit)1000
phonestringRecipient mobile number (required for submit)01712345678
typestringTransaction type: cash-in or cash-out (required for submit)cash-in
transaction_idintegerTransaction ID (required for status check)1

PHP Example

Check MFS List
<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://rasi.top/api/mfs.php",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query([
        "api_key" => "XXXAPIKEY",
        "api_secret" => "XXXSECRETKEY",
        "action" => "check"
    ]),
]);
$response = curl_exec($curl);
curl_close($curl);
$data = json_decode($response, true);
print_r($data);
?>
Submit Transaction
<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://rasi.top/api/mfs.php",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query([
        "api_key" => "XXXAPIKEY",
        "api_secret" => "XXXSECRETKEY",
        "action" => "submit",
        "mfs_id" => 1,
        "amount" => 1000,
        "phone" => "01712345678",
        "type" => "cash-in"
    ]),
]);
$response = curl_exec($curl);
curl_close($curl);
$data = json_decode($response, true);
print_r($data);
?>
Check Transaction Status
<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://rasi.top/api/mfs.php",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query([
        "api_key" => "XXXAPIKEY",
        "api_secret" => "XXXSECRETKEY",
        "action" => "status",
        "transaction_id" => 1
    ]),
]);
$response = curl_exec($curl);
curl_close($curl);
$data = json_decode($response, true);
print_r($data);
?>

cURL Example

# Check MFS List
curl -X POST https://rasi.top/api/mfs.php -d "api_key=XXXAPIKEY" -d "api_secret=XXXSECRETKEY" -d "action=check"

# Submit Transaction
curl -X POST https://rasi.top/api/mfs.php \
-d "api_key=XXXAPIKEY" \
-d "api_secret=XXXSECRETKEY" \
-d "action=submit" \
-d "mfs_id=1" \
-d "amount=1000" \
-d "phone=01712345678" \
-d "type=cash-in"

# Check Transaction Status
curl -X POST https://rasi.top/api/mfs.php \
-d "api_key=XXXAPIKEY" \
-d "api_secret=XXXSECRETKEY" \
-d "action=status" \
-d "transaction_id=1"

Responses

Success Responses
Before Admin Update
{
  "success": true,
  "transactionId": "7",
  "status": "Success",
  "amount": "1000.00",
  "commission": "2.00",
  "charge": "0.00",
  "total_deducted": "1000.00",
  "response": "Successful",
  "mfs_transaction_id": null,
  "sender_number": null
}
After Admin Update
{
  "success": true,
  "transactionId": "7",
  "status": "Success",
  "amount": "1000.00",
  "commission": "2.00",
  "charge": "0.00",
  "total_deducted": "1000.00",
  "response": "Successful",
  "mfs_transaction_id": "BG58S76SR7",
  "sender_number": "01812000111"
}
Error Responses
{
  "error": "Missing required parameters."
}
{
  "error": "Invalid API credentials."
}
{
  "error": "Inactive: Your API is not active."
}
{
  "error": "Banned: Your API has been banned."
}
{
  "error": "Insufficient balance."
}
{
  "error": "Transaction failed."
}
{
  "error": "Transaction not found."
}

MFS List (Active)

MFS Name ID Type Status
Bkash 1 cash-in active
Nagad 2 cash-in active