<?php
$url = 'https://sandbox.propel.co.ke/api/v1/auth/token/?grant_type=client_credentials';
$requestBody = array(
  'client_id' => 'CLIENT_ID',
  'client_secret' => 'CLIENT_SECRET',
);
$headers = array(
  'Authorization: Basic ' . base64_encode($requestBody['client_id'] . ':' . $requestBody['client_secret']),
);

$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => $headers
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

import requests
from requests.auth import HTTPBasicAuth

url = "https://sandbox.propel.co.ke/api/v1/auth/token/?grant_type=client_credentials"
client_id = "CLIENT_ID"
client_secret = "CLIENT_SECRET"

response = requests.get(url, auth=HTTPBasicAuth(client_id, client_secret))
print(response.json())

import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Base64;

public class PropelToken {
  public static void main(String[] args) throws Exception {
    String clientId = "CLIENT_ID";
    String clientSecret = "CLIENT_SECRET";
    String auth = clientId + ":" + clientSecret;
    String encodedAuth = Base64.getEncoder().encodeToString(auth.getBytes());

    URL url = new URL("https://sandbox.propel.co.ke/api/v1/auth/token/?grant_type=client_credentials");
    HttpURLConnection conn = (HttpURLConnection) url.openConnection();
    conn.setRequestMethod("GET");
    conn.setRequestProperty("Authorization", "Basic " + encodedAuth);

    // Read response...
  }
}

<?php
$merchantCode = '50**1';
$bearerToken = '<YOUR-ACCESS-TOKEN>';
$url = "https://sandbox.propel.co.ke/api/v1/accounts/balance/?MerchantCode=" . $merchantCode;

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer $bearerToken",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);

if($response === false) {
    echo "cURL Error: " . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);
?>

import requests

merchant_code = "50**1"
access_token = "<YOUR-ACCESS-TOKEN>"
url = f"https://sandbox.propel.co.ke/api/v1/accounts/balance/?MerchantCode={merchant_code}"

headers = {
    "Authorization": f"Bearer {access_token}",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

import java.net.HttpURLConnection;
import java.net.URL;

public class AccountBalance {
  public static void main(String[] args) throws Exception {
    String merchantCode = "50**1";
    String token = "<YOUR-ACCESS-TOKEN>";
    URL url = new URL("https://sandbox.propel.co.ke/api/v1/accounts/balance/?MerchantCode=" + merchantCode);

    HttpURLConnection conn = (HttpURLConnection) url.openConnection();
    conn.setRequestMethod("GET");
    conn.setRequestProperty("Authorization", "Bearer " + token);
    conn.setRequestProperty("Content-Type", "application/json");

    // Read and handle response...
  }
}

{
  "status": false,
  "detail": "Invalid or expired token",
  "message": "Unauthorized access",
  "ResponseCode": "401"
}

<?php
$merchantCode = '5125';
$startDate = '2024-03-01';
$endDate = '2024-03-25';
$perPage = 15;
$accessToken = '<YOUR-ACCESS-TOKEN>';

$url = "https://api.propel.co.ke/api/v1/accounts/transactions?MerchantCode=$merchantCode&StartDate=$startDate&EndDate=$endDate&per_page=$perPage";

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $accessToken",
        "Content-Type: application/json"
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

import requests

url = "https://api.propel.co.ke/api/sandbox/v1/accounts/transactions"
params = {
    "MerchantCode": "5125",
    "StartDate": "2024-03-01",
    "EndDate": "2024-03-25",
    "per_page": 15
}
headers = {
    "Authorization": "Bearer <YOUR-ACCESS-TOKEN>",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

import java.net.HttpURLConnection;
import java.net.URL;

public class TransactionStatement {
  public static void main(String[] args) throws Exception {
    String merchantCode = "5125";
    String startDate = "2024-03-01";
    String endDate = "2024-03-25";
    int perPage = 15;
    String token = "<YOUR-ACCESS-TOKEN>";

    String urlStr = String.format(
      "https://api.propel.co.ke/sandbox/api/v1/accounts/transactions?MerchantCode=%s&StartDate=%s&EndDate=%s&per_page=%d",
      merchantCode, startDate, endDate, perPage
    );

    URL url = new URL(urlStr);
    HttpURLConnection conn = (HttpURLConnection) url.openConnection();
    conn.setRequestMethod("GET");
    conn.setRequestProperty("Authorization", "Bearer " + token);
    conn.setRequestProperty("Content-Type", "application/json");

    // Handle response...
  }
}

{
  "status": "false",
  "message": "Invalid or expired access token.",
  "detail": "Invalid or expired access token.",
  "ResponseCode": 401
}

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.propel.co.ke/sandbox/api/v1/send-money/send-to-mobile',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => array(
    'MerchantCode' => '5126',
    'Amount' => '20',
    'Currency' => 'KES',
    'ReceiverNumber' => '0759231969',
    'Channel' => '63902',
    'Reason' => 'test',
    'InitiatorTransactionReference' => '12894850',
    'CallBackUrl' => 'https://your-callback.url'
  ),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer <YOUR-ACCESS-TOKEN>'
  ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

import requests

url = "https://api.propel.co.ke/sandbox/api/v1/send-money/send-to-mobile"
payload = {
    "MerchantCode": "5126",
    "Amount": "20",
    "Currency": "KES",
    "ReceiverNumber": "0759231969",
    "Channel": "63902",
    "Reason": "test",
    "InitiatorTransactionReference": "12894850",
    "CallBackUrl": "https://your-callback.url"
}
headers = {
    "Authorization": "Bearer <YOUR-ACCESS-TOKEN>"
}

response = requests.post(url, data=payload, headers=headers)
print(response.json())

import java.io.*;
import java.net.*;
import java.util.*;

public class SendMoneyMobile {
  public static void main(String[] args) throws IOException {
    String url = "https://api.propel.co.ke/sandbox/api/v1/send-money/send-to-mobile";
    String token = "<YOUR-ACCESS-TOKEN>";

    String data = "MerchantCode=5126&Amount=20&Currency=KES&ReceiverNumber=0759231969" +
                  "&Channel=63902&Reason=test&InitiatorTransactionReference=12894850" +
                  "&CallBackUrl=https://your-callback.url";

    HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
    conn.setRequestMethod("POST");
    conn.setDoOutput(true);
    conn.setRequestProperty("Authorization", "Bearer " + token);
    conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");

    OutputStream os = conn.getOutputStream();
    os.write(data.getBytes());
    os.flush();
    os.close();

    BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()));
    String line;
    while ((line = br.readLine()) != null) {
      System.out.println(line);
    }
    br.close();
  }
}

{
  "status": false,
  "message": "Duplicate InitiatorTransactionReference  detected.",
  "details": "use unique InitiatorTransactionReference.",
  "ResponseCode": "409"
}

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api/sandbox/v1/send-money/send-to-bank',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array(
    'MerchantCode' => '5126',
    'Amount' => '20',
    'Currency' => 'KES',
    'ReceiverNumber' => '0759231969',
    'Channel' => '123456',
    'Reason' => 'test',
    'InitiatorTransactionReference' => '12894850',
    'CallBackUrl' => 'https://webhook.site/your-callback-url'
  ),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer <YOUR-ACCESS-TOKEN>'
  ),
));

$response = curl_exec($curl);
curl_close($curl);

echo $response;
?>

import requests

url = "https://api/sandbox/v1/send-money/send-to-bank"
payload = {
  "MerchantCode": "5126",
  "Amount": "20",
  "Currency": "KES",
  "ReceiverNumber": "0759231969",
  "Channel": "123456",
  "Reason": "test",
  "InitiatorTransactionReference": "12894850",
  "CallBackUrl": "https://webhook.site/your-callback-url"
}
headers = {
  "Authorization": "Bearer <YOUR-ACCESS-TOKEN>"
}

response = requests.post(url, data=payload, headers=headers)
print(response.json())

import java.io.*;
import java.net.*;
import java.util.*;

public class SendToBank {
  public static void main(String[] args) throws Exception {
    URL url = new URL("https://api/sandbox/v1/send-money/send-to-bank");
    HttpURLConnection conn = (HttpURLConnection) url.openConnection();
    conn.setRequestMethod("POST");
    conn.setDoOutput(true);
    conn.setRequestProperty("Authorization", "Bearer <YOUR-ACCESS-TOKEN>");

    String data = "MerchantCode=5126&Amount=20&Currency=KES&ReceiverNumber=0759231969&Channel=123456&Reason=test&InitiatorTransactionReference=12894850&CallBackUrl=https://webhook.site/your-callback-url";

    try (OutputStream os = conn.getOutputStream()) {
      byte[] input = data.getBytes("utf-8");
      os.write(input, 0, input.length);
    }

    // Handle response...
  }
}

{
  "status": false,
  "message": "Duplicate InitiatorTransactionReference  detected.",
  "details": "use unique InitiatorTransactionReference.",
  "ResponseCode": "409"
}

<?php
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.propel.co.ke/api/sandbox/v1/send-money/b2b',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => [
    'MerchantCode' => '5125',
    'Amount' => '100',
    'Currency' => 'KES',
    'BusinessNumber' => '247247',
    'Channel' => '63902',
    'Reason' => 'test',
    'InitiatorTransactionReference' => '1247545ee744t443',
    'CallBackUrl' => 'https://webhook.site/your-callback-url',
    'BusinessType' => 'PAYBILL',
    'AccountNumber' => '0650199612624',
  ],
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer <YOUR-ACCESS-TOKEN>',
  ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

import requests

url = "https://api.propel.co.ke/api/sandbox/v1/send-money/b2b"
data = {
  "MerchantCode": "5125",
  "Amount": "100",
  "Currency": "KES",
  "BusinessNumber": "247247",
  "Channel": "63902",
  "Reason": "test",
  "InitiatorTransactionReference": "1247545ee744t443",
  "CallBackUrl": "https://webhook.site/your-callback-url",
  "BusinessType": "PAYBILL",
  "AccountNumber": "0650199612624"
}

headers = {
  "Authorization": "Bearer <YOUR-ACCESS-TOKEN>"
}

response = requests.post(url, headers=headers, data=data)
print(response.json())

// Java implementation would typically use HttpClient or HttpURLConnection
// Sample placeholder:

// Build POST body and send using Java HttpClient
// Set Authorization header to: Bearer <YOUR-ACCESS-TOKEN>

{
  "status": false,
  "message": "Duplicate InitiatorTransactionReference  detected.",
  "details": "use unique InitiatorTransactionReference.",
  "ResponseCode": "409"
}

<?php
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.propel.co.ke/api/sandbox/v1/collection/initiate',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => [
    'MerchantCode' => '5125',
    'Amount' => '10',
    'Currency' => 'KES',
    'PhoneNumber' => '0759231969',
    'Channel' => '63902',
    'CallBackUrl' => 'https://webhook.site/your-callback-url',
    'Reason' => '33',
    'InitiatorTransactionReference' => '4334315w2',
  ],
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer <YOUR-ACCESS-TOKEN>',
  ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

import requests

url = "https://api.propel.co.ke/api/sandbox/v1/collection/initiate"
data = {
  "MerchantCode": "5125",
  "Amount": "10",
  "Currency": "KES",
  "PhoneNumber": "0759231969",
  "Channel": "63902",
  "CallBackUrl": "https://webhook.site/your-callback-url",
  "Reason": "33",
  "InitiatorTransactionReference": "4334315w2"
}

headers = {
  "Authorization": "Bearer <YOUR-ACCESS-TOKEN>"
}

response = requests.post(url, headers=headers, data=data)
print(response.json())

// Java HttpClient or HttpURLConnection setup goes here
// Sample: send POST request with fields above
// Include Authorization header: Bearer <YOUR-ACCESS-TOKEN>

{
  "status": false,
  "message": "Transaction failed. Insufficient balance.",
  "details": "Please check your balance and try again.",
  "ResponseCode": "400"
}