Bohudur PHP SDK

Developer-first PHP SDK for Bohudur Payment Automation Platform.

Requirements

Requirement	Value
PHP Version	7.4 or higher
Extensions	curl, json
Environment	Server-side only

Installation

Step 1: Download SDK

Download the SDK, extract the ZIP file, and save the SDK file as:

text

bohudur.php

Step 2: Include SDK

php

define('BOHUDUR', true);
require 'bohudur.php';

Important

Direct access is blocked unless the BOHUDUR constant is defined.

Authentication

All API requests are authenticated using an API Key.

Initialization (Required)

php

Bohudur::init('YOUR_API_KEY');

Important

Never expose your Bohudur API Key in frontend JavaScript, mobile apps, or public repositories. Always use the PHP SDK on a secure server.

Validation Rules

Rule	Description
Required	Yes
Format	Alphanumeric only
Scope	Global (static)

If initialization is skipped, all requests will fail.

API Flow

1. Bohudur::Request()->Send()   → Get payment_url + paymentkey
        ↓
2. Redirect user to payment_url
        ↓
3. User pays or cancels on hosted checkout
        ↓
4. Bohudur::Execute('key')      → Confirm and finalize the payment
        ↓
5. Webhook sent to your server (if configured)
        ↓
6. Bohudur::Query('key')        → Check status anytime

Create Payment API (PHP)

Creates a new payment session and returns a hosted checkout URL.

PHP Example

php

$response = Bohudur::Request()
    ->FullName('Jane Doe')
    ->Email('janedoe@gmail.com')
    ->Amount(10)
    ->ReturnType('GET')
    ->RedirectUrl('https://example.com/redirect/')
    ->CancelUrl('https://example.com/cancel/')
    ->Metadata([
        'order_id' => 'ORD-1001',
        'user_id'  => 55
    ])
    ->Webhook([
        'success' => 'https://example.com/success.php',
        'cancel'  => 'https://example.com/cancel.php'
    ])
    ->Send();

Create Payment Parameters

Method	Required	Type	Description
`FullName()`	YES	string	Customer full name
`Email()`	YES	string	Customer email
`Amount()`	YES	float	Payment amount
`ReturnType()`	YES	string	`GET` or `POST`
`RedirectUrl()`	YES	string	Redirect URL after success
`CancelUrl()`	YES	string	Redirect URL after cancellation
`Metadata()`	NO	array	Custom key-value data
`Webhook()`	NO	array	Webhook URLs

Success Response

Returned when payment creation is successful.

php

[
  "responseCode" => 200,
  "message" => "Payment created successfully",
  "status" => "success",
  "paymentkey" => "5RWS4w2w1R5nFAvoP5U0JS4O74UrMXGt",
  "payment_url" => "https://checkout.bohudur.one/payment/5RWS4w2w1R5nFAvoP5U0JS4O74UrMXGt"
]

Response Fields Explained

Field	Type	Description
`responseCode`	number	HTTP-like response code. `200` indicates success.
`message`	string	Human-readable message describing the result.
`status`	string	Payment creation status. Always `success` on success.
`paymentkey`	string	A unique 32-character alphanumeric key generated for each payment.
`payment_url`	string	Hosted checkout URL where the customer completes the payment.

Failed Response

php

[
  "responseCode" => 3018,
  "message" => "Oops! Internal error. Try again",
  "status" => "failed"
]

Create Payment Error Codes (PHP)

The following table lists all possible error codes returned by the Create Payment API.

Code	Message	Description
`3000`	API key not found	`AH-BOHUDUR-API-KEY` header is missing
`3001`	Required parameters not found	One or more required fields are missing
`3002`	--- parameter is empty	Specific field value is empty
`3003`	Invalid Full Name Format	`full_name` must be a valid non-empty string
`3004`	Invalid Email Format	Email address is not valid
`3005`	Invalid Amount Format	Amount must be a positive numeric value
`3006`	Invalid Return Type Format	Only `GET` or `POST` allowed
`3007`	Invalid Return URL Format	`redirect_url` is not a valid URL
`3008`	Invalid Cancel URL Format	`cancel_url` is not a valid URL
`3009`	Invalid JSON format in metadata	`metadata` must be a valid JSON object
`3010`	Invalid JSON format in webhook	`webhook` must be a valid JSON object
`3011`	Invalid webhook actions	Only `success` and `cancel` keys allowed in webhook
`3012`	Invalid JSON format in metadata or webhook	One or both JSON objects are malformed
`3013`	Invalid API key	API key is incorrect or inactive
`3014`	Oops! internal error. Try again.	Temporary server-side issue — retry
`3015`	Unknown amount provided	Amount value is not acceptable
`3016`	You don't have access	Request blocked due to IP restriction
`3017`	Oops! Internal error. Try again.	Unexpected internal server error
`3018`	Unable to create payment	Payment session could not be created

Redirecting Customer

php

if ($response['status'] === 'success') {
    header('Location =>' . $response['payment_url']);
    exit;
}

Execute Payment API (PHP)

Finalizes a completed payment.

PHP Example

php

$execute = Bohudur::Execute('PAYMENT_KEY');

Execution Rules

Can be executed only once
Payment must be COMPLETED
Executed payments are final

Success Response

php

[
  "full_name" => "Gabriel Adams",
  "email" => "jsondoe@gmail.com",
  "amount" => 40,
  "converted_amount" => 4878,
  "total_amount" => 40,
  "transaction_fee" => 0,
  "default_currency" => "USD",
  "payment_currency" => "BDT",
  "currency_value" => 121.951,
  "metadata" =>[],
  "created_time" => "2026-01-04 16:04:35",
  "payment_time" => "2026-01-04 16:12:37",
  "paymentkey" => "fnPwIkdIsMjN4FJxYxw6DF75GuW9qStn",
  "receipt" => "https://pay.bohudur.one/receipt/download/102f89389f9e",
  "webhook" =>[],
  "payment_info" => [
    "m0" => "Stripe",
    more....
  ],
  "status" => "EXECUTED"
]

Response Parameters

Field	Type	Description
`full_name`	string	Customer’s full name
`email`	string	Customer’s email address
`amount`	number	Original payment amount in default currency
`converted_amount`	number	Amount converted to the payment currency
`total_amount`	number	Total amount charged (amount + fees)
`transaction_fee`	number	Transaction fees applied (if any)
`default_currency`	string	Your account default currency
`payment_currency`	string	Currency used for the payment
`currency_value`	number	Conversion rate applied (default → payment currency)
`metadata`	array	Optional metadata submitted during creation
`created_time`	string	Payment creation timestamp
`payment_time`	string	Time when the payment was completed by the customer
`paymentkey`	string	Unique key identifying this payment
`webhook`	array	Webhook URLs configured for this payment
`receipt`	string	URL to download the PDF receipt for this payment
`payment_info`	object	Transaction-specific info
`status`	string	Payment execution status. Always `EXECUTED` on success

Error Response Example

php

[
  "responseCode" => 3108,
  "message" => "Payment already executed!",
  "status" => "failed"
]

Common Error Codes

Code	Message	Description
`3100`	API key not found	The request did not include an API key. Ensure the `AH-BOHUDUR-API-KEY` header is set.
`3101`	API key not valid	The provided API key is invalid or inactive.
`3102`	Invalid Payment Key	The `paymentkey` provided is malformed or does not exist.
`3103`	Invalid api key	The API key used does not match any active account.
`3104`	You don't have access! Your IP =>...	Your IP address is not authorized to perform this request. Replace`...`with your server IP in the message.
`3105`	Payment Data Not Found	No payment data exists for the given `paymentkey`.
`3106`	Payment is pending!	The payment has not yet been completed by the customer. Execute is only allowed after completion.
`3107`	Payment is cancelled!	The payment was cancelled by the customer or system.
`3108`	Payment already executed!	This payment has already been executed. Execution can only happen once.
`3109`	Failed to execute payment	The payment could not be executed due to a server or processing error.

Important

The Execute API is idempotent by design.
A payment can only be executed once. Any attempt to execute the same payment again will return Payment already executed!.
This prevents duplicate payments.

Query Payment API (PHP)

Retrieve payment data at any time.

PHP Example

php

$query = Bohudur::Query('PAYMENT_KEY');

Response Types

The Query API can return four types of responses, depending on the payment status.

1. PENDING Payment

Payment created but not yet completed by the user.

php

[
  "full_name" => "Chloe Morales",
  "email" => "demo@gmail.com",
  "amount" => 1,
  "converted_amount" => 1,
  "total_amount" => 1,
  "transaction_fee" => 0,
  "default_currency" => "USD",
  "payment_currency" => "USD",
  "currency_value" => 1,
  "metadata" => [],
  "created_time" => "2026-01-07 10:02:20",
  "payment_time" => "NONE",
  "paymentkey" => "7QWQsOhg9X7dgQlfRO4EPxWKK9qaCWka",
  "receipt" => "NONE",
  "webhook" => [],
  "payment_info" => [],
  "status" => "PENDING"
]

2. COMPLETED Payment

Payment successfully completed by the user.

php

[
  "full_name" => "Jane Doe",
  "email" => "demo@gmail.com",
  "amount" => 150,
  "converted_amount" => 150,
  "total_amount" => 150,
  "transaction_fee" => 0,
  "default_currency" => "USD",
  "payment_currency" => "USD",
  "currency_value" => 1,
  "metadata" => [],
  "created_time" => "2025-12-11 21:47:11",
  "payment_time" => "2025-12-11 23:11:25",
  "paymentkey" => "TYtsYll15iqsDqsR4h8EJrMfou9NavE2",
  "receipt" => "https://pay.bohudur.one/receipt/download/102f89389f9e",
  "webhook" => [],
  "payment_info" => [
    "m0" => "Stripe",
    more....
  ],
  "status" => "COMPLETED"
]

Explanation

payment_time → Timestamp when payment was completed
payment_info → Contains transaction details (processor-specific info)
status → COMPLETED indicates payment is successful and ready for execution

3. EXECUTED Payment

Payment has been executed/confirmed via the Execute API.

php

[
  "full_name" => "Gabriel Adams",
  "email" => "demo@gmail.com",
  "amount" => 40,
  "converted_amount" => 4878,
  "total_amount" => 40,
  "transaction_fee" => 0,
  "default_currency" => "USD",
  "payment_currency" => "BDT",
  "currency_value" => 121.951,
  "metadata" => [],
  "created_time" => "2026-01-04 16:04:35",
  "payment_time" => "2026-01-04 16:12:37",
  "paymentkey" => "fnPwIkdIsMjN4FJxYxw6DF0I92W9qStn",
  "webhook" => [],
  "payment_info" => [
    "m0" => "Stripe",
    more....
  ],
  "status" => "EXECUTED"
]

Important

An executed payment is final and cannot be executed again. This protects your system from duplicate payments and ensures each payment key is one-time use only.

4. CANCELLED Payment

Payment that was cancelled by the user or system.

php

[
  "full_name" => "Jane Doe",
  "email" => "demo@gmail.com",
  "amount" => 1,
  "converted_amount" => 1,
  "total_amount" => 1,
  "transaction_fee" => 0,
  "default_currency" => "USD",
  "payment_currency" => "USD",
  "currency_value" => 1,
  "metadata" => [
    "data1" => "value1",
    "data2" => "value2"
  ],
  "created_time" => "2026-01-18 19:30:56",
  "payment_time" => "NONE",
  "paymentkey" => "P4m1OEiopqPy4cFx9QO0mARuzqxx7bsf",
  "receipt" => "NONE",
  "webhook" => [
    "success" => "https://example.com/success.php",
    "cancel" => "https://example.com/cancel.php"
  ],
  "payment_info" => [],
  "status" => "CANCELLED"
]

Notice

A cancelled payment cannot be executed. If a user cancels a payment, the payment link becomes inactive and the status is set to CANCELLED.

Explanation

Field	Type	Description
`full_name`	string	Customer’s full name
`email`	string	Customer’s email
`amount`	number	Original payment amount
`converted_amount`	number	Amount converted to payment currency
`total_amount`	number	Total amount including fees
`transaction_fee`	number	Transaction fee applied (if any)
`default_currency`	string	Your account default currency
`payment_currency`	string	Payment currency
`currency_value`	number	Conversion rate applied
`metadata`	array	Optional metadata sent during creation
`created_time`	string	Payment creation timestamp
`payment_time`	string	Time payment completed (`NONE` if pending)
`paymentkey`	string	Unique identifier for this payment
`webhook`	array	Webhook URLs (if configured)
`payment_info`	array	Empty while pending
`status`	string	`PENDING`

Payment Info By Gateways

json

{
    "payment_info": {
        "id": 1,
        "gateway": "bkash",
        "method": "Send Money",
        "number": "01XXXXXXXXX",
        "amount": 100,
        "trx": "TRX123ABC456",
        "time": "01/01/2026 12:00",
        "m0": "Bkash Send Money"
    }
}

json

{
    "payment_info": {
        "id": 1,
        "gateway": "nagad",
        "method": "Send Money",
        "number": "01XXXXXXXXX",
        "amount": 100,
        "trx": "TRX123ABC456",
        "time": "01/01/2026 12:00",
        "m0": "Nagad Send Money"
    }
}

json

{
    "payment_info": {
        "id": 1,
        "gateway": "rocket",
        "method": "Send Money",
        "number": "01XXXXXXXXX",
        "amount": 100,
        "trx": "TRX123ABC456",
        "time": "01/01/2026 12:00",
        "m0": "Rocket Send Money"
    }
}

json

{
    "payment_info": {
        "id": 1,
        "gateway": "upay",
        "method": "Send Money",
        "number": "01XXXXXXXXX",
        "amount": 100,
        "trx": "TRX123ABC456",
        "time": "01/01/2026 12:00",
        "m0": "Upay Send Money"
    }
}

json

{
    "payment_info": {
        "id": 1,
        "gateway": "mcash",
        "method": "Send Money",
        "number": "01XXXXXXXXX",
        "amount": 100,
        "trx": "TRX123ABC456",
        "time": "01/01/2026 12:00",
        "m0": "mCash Send Money"
    }
}

json

{
    "paymentID": "TRX_PAYMENT_ID_EXAMPLE",
    "trxID": "TRX123ABC456",
    "transactionStatus": "Completed",
    "amount": "100",
    "currency": "BDT",
    "intent": "sale",
    "paymentExecuteTime": "2026-01-01T12:00:00 GMT+0600",
    "merchantInvoiceNumber": "invoice_demo_12345",
    "payerType": "Customer",
    "payerReference": "CUSTOMER_REF",
    "customerMsisdn": "01XXXXXXXXX",
    "payerAccount": "01XXXXXXXXX",
    "maxRefundableAmount": "100",
    "statusCode": "0000",
    "statusMessage": "Successful",
    "m0": "Bkash Merchant"
}

json

{
    "status": "VALID",
    "tran_date": "2026-01-01 12:00:00",
    "tran_id": "SSLCZ_DEMO_TRANSACTION",
    "val_id": "VALIDATION_ID_EXAMPLE",
    "amount": "100.00",
    "store_amount": "97.50",
    "currency": "BDT",
    "bank_tran_id": "BANK_TRANSACTION_ID",
    "card_type": "NAGAD-Nagad",
    "card_no": "",
    "card_issuer": "Nagad",
    "card_brand": "MOBILEBANKING",
    "card_category": "MOBILE",
    "card_sub_brand": "",
    "card_issuer_country": "Bangladesh",
    "card_issuer_country_code": "BD",
    "currency_type": "BDT",
    "currency_amount": "100.00",
    "currency_rate": "1.0000",
    "base_fair": "0.00",
    "value_a": "",
    "value_b": "",
    "value_c": "",
    "value_d": "",
    "emi_instalment": "0",
    "emi_amount": "0.00",
    "emi_description": "",
    "emi_issuer": "Nagad",
    "account_details": "",
    "risk_title": "Safe",
    "risk_level": "0",
    "discount_percentage": "0",
    "discount_amount": "0.00",
    "discount_remarks": "",
    "APIConnect": "DONE",
    "validated_on": "2026-01-01 12:00:10",
    "gw_version": "",
    "offer_avail": 1,
    "card_ref_id": "CARD_REFERENCE_ID_EXAMPLE",
    "isTokeizeSuccess": 0,
    "campaign_code": "",
    "m0": "SSLCommerz"
}

json

{
    "id": "pi_demo_payment_intent",
    "object": "payment_intent",
    "amount": 10000,
    "amount_capturable": 0,
    "amount_details": {
        "tip": []
    },
    "amount_received": 10000,
    "application": null,
    "application_fee_amount": null,
    "automatic_payment_methods": null,
    "canceled_at": null,
    "cancellation_reason": null,
    "capture_method": "automatic_async",
    "client_secret": "pi_demo_payment_intent_secret_example",
    "confirmation_method": "automatic",
    "created": 1767225600,
    "currency": "usd",
    "customer": null,
    "customer_account": null,
    "description": "Demo Payment",
    "excluded_payment_method_types": null,
    "last_payment_error": null,
    "latest_charge": "ch_demo_charge_id",
    "livemode": false,
    "managed_payments": {
        "enabled": false
    },
    "metadata": [],
    "next_action": null,
    "on_behalf_of": null,
    "payment_details": {
        "customer_reference": null,
        "order_reference": "ORDER_REFERENCE_EXAMPLE"
    },
    "payment_method": "pm_demo_payment_method",
    "payment_method_configuration_details": null,
    "payment_method_options": {
        "card": {
            "installments": null,
            "mandate_options": null,
            "network": null,
            "request_three_d_secure": "automatic"
        }
    },
    "payment_method_types": [
        "card"
    ],
    "presentment_details": {
        "presentment_amount": 12000,
        "presentment_currency": "bdt"
    },
    "processing": null,
    "receipt_email": "customer@example.com",
    "review": null,
    "setup_future_usage": null,
    "shared_payment_granted_token": null,
    "shipping": null,
    "source": null,
    "statement_descriptor": null,
    "statement_descriptor_suffix": null,
    "status": "succeeded",
    "transfer_data": null,
    "transfer_group": null,
    "m0": "Stripe"
}

json

{
    "uid": 123456789,
    "counterpartyId": 987654321,
    "orderId": "ORDER_ID_EXAMPLE",
    "orderType": "CRYPTO_BOX",
    "transactionId": "TRANSACTION_ID_EXAMPLE",
    "transactionTime": 1767225600000,
    "amount": "10.00",
    "currency": "USDT",
    "walletType": 1,
    "walletTypes": [
        "1"
    ],
    "fundsDetail": [
        {
            "currency": "USDT",
            "amount": "10.00"
            "walletAssetCost": {
                "1": "10.00"
            }
        }
    ],
    "payerInfo": {
        "name": "John Doe",
        "type": "USER",
        "email": "customer@example.com",
        "countryCode": 880,
        "phoneNumber": "01XXXXXXXXX",
        "mobileCode": "BD",
        "unmaskData": false
    },
    "receiverInfo": {
        "binanceId": 123456789,
        "accountId": 987654321,
        "unmaskData": false
    },
    "totalPaymentFee": "0",
    "m0": "Binance Personal"
}

Error Codes

Code	Message	Description
`3050`	API key not found	Request missing the `AH-BOHUDUR-API-KEY` header
`3051`	API key not valid	API key is invalid or inactive
`3052`	Invalid Payment Key	Provided `paymentkey` does not exist or is malformed
`3053`	Invalid api key	API key does not match an active account
`3054`	You don't have access! Your IP: ...	Request blocked due to IP restrictions
`3055`	Payment Data Not Found	No payment data exists for the given `paymentkey`

Webhooks (PHP)

Bohudur sends webhook notifications using POST JSON.

Success Webhook Payload

php

[
  "full_name" => "Jane Doe",
  "email" => "janedoe@gmail.com",
  "amount" => 1,
  "paymentkey" => "CrD85r3ibMK6ip38reUcuECvVhaF0xOT",
  "status" => "COMPLETED"
]

Cancel Webhook Payload

php

[
  "full_name" => "Jane Doe",
  "email" => "janedoe@gmail.com",
  "amount" => 1,
  "paymentkey" => "CrD85r3ibMK6ip38reUcuECvVhaF0xOT",
  "status" => "CANCELLED"
]

Webhook Handler Example

php

$data = json_decode(file_get_contents('php://input'), true);

// Always verify
Bohudur::Query($data['paymentkey']);

Best Practices (Critical)

Practice	Description
Always verify using Query API	Always verify webhook data by calling `Bohudur::Query()`
Never execute from frontend	All payment execution must happen server-side
Webhooks ≠ final truth	Webhooks can be delayed; use Query API as source of truth
Execute only once	Implement idempotency checks to prevent duplicate execution

Support

Telegram: t.me/bohudur
Facebook Group: Group
YouTube: youtube.com/@bohudurpay

Bohudur PHP SDK ​

Requirements ​

Installation ​

Step 1: Download SDK ​

Step 2: Include SDK ​

Authentication ​

Initialization (Required) ​

Validation Rules ​

API Flow ​

Create Payment API (PHP) ​

PHP Example ​

Create Payment Parameters ​

Success Response ​

Response Fields Explained ​

Failed Response ​

Create Payment Error Codes (PHP) ​

Redirecting Customer ​

Execute Payment API (PHP) ​

PHP Example ​

Execution Rules ​

Success Response ​

Response Parameters ​

Error Response Example ​

Common Error Codes ​

Query Payment API (PHP) ​

PHP Example ​

Response Types ​

1. PENDING Payment ​

2. COMPLETED Payment ​

Explanation ​

3. EXECUTED Payment ​

4. CANCELLED Payment ​

Explanation ​

Payment Info By Gateways ​

Error Codes ​

Webhooks (PHP) ​

Success Webhook Payload ​

Cancel Webhook Payload ​

Webhook Handler Example ​

Best Practices (Critical) ​

Support ​

Bohudur PHP SDK

Requirements

Installation

Step 1: Download SDK

Step 2: Include SDK

Authentication

Initialization (Required)

Validation Rules

API Flow

Create Payment API (PHP)

PHP Example

Create Payment Parameters

Success Response

Response Fields Explained

Failed Response

Create Payment Error Codes (PHP)

Redirecting Customer

Execute Payment API (PHP)

PHP Example

Execution Rules

Success Response

Response Parameters

Error Response Example

Common Error Codes

Query Payment API (PHP)

PHP Example

Response Types

1. PENDING Payment

2. COMPLETED Payment

Explanation

3. EXECUTED Payment

4. CANCELLED Payment

Explanation

Payment Info By Gateways

Error Codes

Webhooks (PHP)

Success Webhook Payload

Cancel Webhook Payload

Webhook Handler Example

Best Practices (Critical)

Support