Интегрируйте bKash в свое приложение (Android/iOS)

Интегрируйте bKash в свое приложение

Как эксперт по платежным платформам, я могу подсказать вам, как интегрировать платежную систему bKash в ваше мобильное приложение. Ниже представлено подробное пошаговое руководство:

1. Предварительная подготовка

  • Зарегистрируйте торговый счет: Во-первых, вам нужно добавить новый файл вПортал для торговцев bKashЗарегистрируйтесь и получите необходимые учетные данные API
  • Выберите тип интеграции: Определите, нужен ли вам API Checkout (простой) или API Payment (более гибкий).
  • Получение документации API: Загрузите последнюю версию документации по API и SDK с портала для разработчиков bKash.

2. Этапы интеграции приложения Android

a. Добавление зависимостей

реализация 'com.bkash:paymentgateway:3.0.0'

b. Инициализация SDK

BkashPayment bkashPayment = new BkashPayment();
bkashPayment.init(this, "YOUR_MERCHANT_API_KEY", "YOUR_MERCHANT_USERNAME");

c. Создание запросов на оплату

JSONObject paymentRequest = новый JSONObject();
попробуйте {
paymentRequest.put("amount", "100");
paymentRequest.put("намерение", "продажа");
// ... Другие необходимые параметры...
} catch (JSONException e) {
e.printStackTrace();
}

3. Этапы интеграции приложений для iOS

a. Установка CocoaPods

pod 'bKashiOSFramework'

b. Пример кода инициализации Swift

let bkashiOS = BkashiOS.sharedInstance()
bkashiOS?.initialise(withMerchantID: "YOUR_MERCHANT_ID",
merchantUsername: "YOUR_USERNAME",
apiKey: "YOUR_API_KEY")

4. Элементы интеграции Web/back-end

  • URL-адрес обратного вызова для проверки достоверности: Убедитесь, что настроены правильные конечные точки URL обратного вызова успеха/неудачи.
  • Обработка IPN: Реализуйте слушатель уведомлений о мгновенных платежах для обработки асинхронных уведомлений
  • мера безопасности::
    • SSL-сертификат должен быть действительным и обновленным
    • Процесс аутентификации OAuth2 реализован корректно

5. Тестирование и ввод в эксплуатацию

✅ Среда "песочницы" для тестирования всех сценариев (успех, неудача, отмена и т. д.)
✅ Проверка адаптации пользовательского интерфейса (особенно проблем с отображением в темном цветовом режиме)
✅ Проверка соответствия требованиям PCI DSS (если хранятся конфиденциальные данные)

Нужны более подробные сведения о конкретной части реализации? Например, примеры кода для конкретного языка или лучшие практики обработки ошибок?

Подробные сведения об интеграции платежей bKash

Я с удовольствием продолжаю предоставлять вам подробный обзор ключевых аспектов интеграции с bKash. Ниже представлено более подробное руководство по внедрению:

1. глубокая интеграция Android

a. Завершение обработки процесса оплаты

// Создайте образец запроса на полную оплату
BkashPaymentRequest request = new BkashPaymentRequest.Builder()
.setAmount("500.50")
.setMerchantInvoiceNumber("ORD "+System.currentTimeMillis())
.setCallbackURL("https://yourdomain.com/bkash/callback")
.build();

bkashPayment.createPayment(request, new PaymentListener() {
@Override
public void onSuccess(JSONObject data) {
// Необходимо подтвердить идентификатор транзакции на стороне сервера
String paymentID = data.optString("paymentID");
verifyWithBackend(paymentID).
}

@Override
public void onFailure(String errorMessage) {
showErrorDialog(errorMessage);
}
});

b. Пользовательская настройка WebView (если требуется)

<activity android:name="com.bka.sh.pgw.ui.PaymentActivity"
android:theme="@style/YourCustomTheme" />

2. Реализация расширенных функций iOS

a. Адаптационная программа SwiftUI

struct BkashButton: UIViewRepresentable {
var Сумма: Строка

func makeUIView(context: Context) -> UIButton { ... }

func updateUIView(_ uiView: UIButton, context: Context) { ... }
}

b. Примеры кода, совместимого с Objective-C (если требуется)

[[BkashiOS sharedInstance] createPayment:@{
@"amount": @"1200".
@"currency": @"BDT".
} completionHandler^(NSDictionary *response, NSError *error){
if(!error){ /* Обработка успешного ответа */ }
}];

3. Лучшие практики аутентификации безопасности Webhook

Пример валидации PHP на задней панели:

$received_signature = $_SERVER['HTTP_X_BKASH_SIGNATURE'];
$payload = file_get_contents('php://input');
$expected_signature = hash_hmac('sha256', $payload, API_SECRET);

if(hash_equals($expected_signature, $received_signature)){
// Логика безопасной обработки...
$transaction_id = json_decode($payload)->paymentID;
updateOrderStatus($transaction_id).
}

Проверка подписи Java Spring Boot Edition:

@PostMapping("/webhook")  
public ResponseEntity handleWebhook(
@RequestBody String payload, @RequestBody String payload, @RequestBody
@RequestHeader("X-BKASH-Signature") String signature){

Mac sha256_HMAC = Mac.getInstance("HmacSHA256");
sha256_HMAC.init(new SecretKeySpec(apiSecret.getBytes(), "HmacSHA256"));

byte[] result = sha256_HMAC.doFinal(payload.getBytes());
String computedSignature = Hex.encodeHexString(result);

if(computedSignature.equals(signature)){...}
}

4. Решение распространенных проблем

проблемное явление Возможные причины Рецепт
Код ошибки:5015 Несоответствие сертификата SSL Обновление корневых сертификатов ЦС
Приложению отказано в доступе к полкам Слишком много разрешений SDK Оптимизация правил Proguard + применение только необходимых разрешений

Что из перечисленного ниже мне нужно выделить? :
1️⃣ Детали взаимодействия с API для процесса возврата средств
2️⃣ Специальный режим для мультивалютных расчетов
3️⃣ Гибридный подход к интеграции разработки с React Native/Flutter