Eng বাং
লগইন রেজিস্ট্রেশন
bKash Transfer API

bKash Transfer API Documentation

Use this API to submit bKash transfer requests and check request status using your API credentials.

Create Account Get API Key

API Endpoint

POST https://nurr.top/api/bkash-transfer.php?action=send
POST https://nurr.top/api/bkash-transfer.php?action=status_check
All requests should be sent using POST.

Authentication

Parameter Required Description
api_key Yes Your API key.
api_secret Yes Your API secret key.

Send Transfer Request

Request Parameters

Parameter Required Example Description
api_key Yes YOUR_API_KEY Your API key.
api_secret Yes YOUR_SECRET_KEY Your API secret key.
recipient_phone Yes 01800000000 Recipient bKash number.
amount Yes 500 Transfer amount.

cURL Example

curl -X POST "https://nurr.top/api/bkash-transfer.php?action=send" \
  -d "api_key=YOUR_API_KEY" \
  -d "api_secret=YOUR_SECRET_KEY" \
  -d "recipient_phone=01800000000" \
  -d "amount=500"

PHP Example

$ch = curl_init("https://nurr.top/api/bkash-transfer.php?action=send");

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => [
        "api_key" => "YOUR_API_KEY",
        "api_secret" => "YOUR_SECRET_KEY",
        "recipient_phone" => "01800000000",
        "amount" => "500"
    ],
    CURLOPT_RETURNTRANSFER => true
]);

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

$data = json_decode($response, true);
print_r($data);

Success Response

{
  "success": true,
  "order_number": "NURR-JFH25SNS5",
  "status": "Processing",
  "recipient_phone": "018XXXX8265",
  "amount": "500.00",
  "charge": "5.00",
  "total_amount": "505.00",
  "message": "bKash transfer request submitted successfully."
}

Status Check

Request Parameters

Parameter Required Example Description
api_key Yes YOUR_API_KEY Your API key.
api_secret Yes YOUR_SECRET_KEY Your API secret key.
order_number Yes NURR-JFH25SNS5 Order number returned from send request.

cURL Example

curl -X POST "https://nurr.top/api/bkash-transfer.php?action=status_check" \
  -d "api_key=YOUR_API_KEY" \
  -d "api_secret=YOUR_SECRET_KEY" \
  -d "order_number=NURR-JFH25SNS5"

Processing Response

{
  "success": true,
  "order_number": "NURR-JFH25SNS5",
  "status": "Processing",
  "recipient_phone": "018XXXX8265",
  "amount": "500.00",
  "charge": "5.00",
  "debit_amount": "505.00",
  "total_amount": "505.00",
  "transaction_type": "mobile-banking",
  "response": "bKash transfer request submitted"
}

Success Response

{
  "success": true,
  "order_number": "NURR-JFH25SNS5",
  "status": "Success",
  "recipient_phone": "018XXXX8265",
  "amount": "500.00",
  "charge": "5.00",
  "debit_amount": "505.00",
  "total_amount": "505.00",
  "transaction_type": "mobile-banking",
  "transaction_id": "BKASH123456789"
}

Cancelled Response

{
  "success": true,
  "order_number": "NURR-JFH25SNS5",
  "status": "Cancelled",
  "recipient_phone": "018XXXX8265",
  "amount": "500.00",
  "charge": "5.00",
  "debit_amount": "505.00",
  "total_amount": "505.00",
  "transaction_type": "mobile-banking",
  "cancel_note": "Invalid bKash number"
}

Error Responses

HTTP Code Error Meaning
400 Invalid action. Invalid or missing action.
401 Invalid API credentials. Invalid API key or secret.
404 Transaction not found. No transaction found for the given order number.
422 Missing required parameters. One or more required parameters are missing.
422 Invalid recipient phone number. Recipient phone number is invalid.
422 Insufficient balance. Account balance is not sufficient.

Error JSON Example

{
  "error": "Invalid API credentials."
}