Платёжное решение BD 1

Обзор методов платежей

• Создание платежей через платёжную карту BDT

Настройка сертификата

По ссылке https://merchant.alikassa.com/cabinet/form/setting-api-certs сгенерируйте «API сертификат на платежи», сохраните архив, распакуйте

Получите:

• password.txt
• private.pem
• public.pem

Мы сохраняем у себя только public.pem для проверки подписи.

Генерация подписи

Оберните все POST данные в json (в том же порядке) и подпишите:

$data = json_encode($data);

$privateKey = openssl_pkey_get_private(
    file_get_contents('private.pem'),
    file_get_contents('password.txt')
);

if ($privateKey === false) {
    throw new \Exception('Ошибка сертификата.');
}

openssl_sign($data, $sign, $privateKey);
$sign = base64_encode($sign);

import { readFileSync } from 'fs';
import { createSign } from 'crypto';

const dataStr = JSON.stringify(data);
const key = readFileSync('private.pem', 'utf8');
const passphrase = readFileSync('password.txt', 'utf8').trim();
const signer = createSign('SHA256');
signer.update(dataStr);
signer.end();
const sign = signer.sign({ key, passphrase }, 'base64');

import json, base64
from cryptography.hazmat.primitives import hashes, serialization
from cryptography.hazmat.primitives.asymmetric import padding

data_bytes = json.dumps(data).encode('utf-8')
with open('password.txt', 'rb') as f:
    password = f.read().strip()
with open('private.pem', 'rb') as f:
    private_key = serialization.load_pem_private_key(f.read(), password=password)
signature = private_key.sign(data_bytes, padding.PKCS1v15(), hashes.SHA256())
sign = base64.b64encode(signature).decode('utf-8')

import java.nio.file.Files;
import java.nio.file.Paths;
import java.security.Signature;
import java.util.Base64;
import org.bouncycastle.openssl.PEMParser;
import org.bouncycastle.openssl.PEMEncryptedKeyPair;
import org.bouncycastle.openssl.jcajce.JcePEMDecryptorProviderBuilder;
import org.bouncycastle.openssl.jcajce.JcaPEMKeyConverter;

byte[] dataBytes = new com.fasterxml.jackson.databind.ObjectMapper().writeValueAsBytes(data);
char[] pass = Files.readString(Paths.get("password.txt")).toCharArray();
PEMParser parser = new PEMParser(Files.newBufferedReader(Paths.get("private.pem")));
PEMEncryptedKeyPair ckp = (PEMEncryptedKeyPair) parser.readObject();
var privateKey = new JcaPEMKeyConverter()
    .getKeyPair(ckp.decryptKeyPair(new JcePEMDecryptorProviderBuilder().build(pass)))
    .getPrivate();
Signature sig = Signature.getInstance("SHA256withRSA");
sig.initSign(privateKey);
sig.update(dataBytes);
String sign = Base64.getEncoder().encodeToString(sig.sign());

import (
    "crypto"
    "crypto/rand"
    "crypto/rsa"
    "crypto/sha256"
    "crypto/x509"
    "encoding/base64"
    "encoding/json"
    "encoding/pem"
    "io/ioutil"
)

dataBytes, _ := json.Marshal(data)
pemBytes, _ := ioutil.ReadFile("private.pem")
passBytes, _ := ioutil.ReadFile("password.txt")
block, _ := pem.Decode(pemBytes)
der, _ := x509.DecryptPEMBlock(block, passBytes)
priv, _ := x509.ParsePKCS1PrivateKey(der)
hash := sha256.Sum256(dataBytes)
sigBytes, _ := rsa.SignPKCS1v15(rand.Reader, priv, crypto.SHA256, hash[:])
sign := base64.StdEncoding.EncodeToString(sigBytes)

Полученный sign передавайте в заголовке Sign.

Создание платежей

URL

POSThttps://api-merchant.alikassa.com/v1/payment📋

Заголовки

Заголовок	Значение
Content-Type	application/json
Account	Ваш uuid счета (вы можете найти в разделе Счета)
Sign	Подпись запроса

Параметры

* - Обязательные поля

Название	Тип	Описание
amount*	decimal (11.2)	Сумма
order_id*	string (128)	Ваш id (должен быть уникальный)
service*	string (100)	payment_card_bdt_hpp
customer_ip*	ip	IP адрес плательщика
customer_code*	string (100)	Код банка для депозита
success_redirect_id	int	Id редиректа при успешной оплате
fail_redirect_id	int	Id редиректа при неуспешной оплате
notification_endpoint_id	int	Id уведомления
success_redirect_url	string|max:255	Ссылка для редиректа после успешной оплаты
fail_redirect_url	string|max:255	Ссылка для редиректа после неуспешной оплаты
notification_endpoint_url	string|max:255	Ссылка для отправки колбека после финализации статусов

Ответ

Название	Описание
url	Ссылка на оплату
payment_status	Статус платежа wait — в процессе оплаты
id	Id платежа AliKassa
uuid	UUID платежа AliKassa
success_redirect_url	Ссылка на вашу страницу, для редиректа клиента после успешной оплаты

Важно

При создании всегда wait, проверяйте статус платежа через API или ждите получение уведомления!

Пример успешного ответа (HTTP CODE 200)

{
  "url": "https://pay-merchant.alikassa.com/bd291fe1-5c19-4113-ae62-a2d3c4d01d20",
  "payment_status": "wait",
  "id": 108465371,
  "uuid": "bd291fe1-5c19-4113-ae62-a2d3c4d01d20",
  "success_redirect_url": null
}

Пример неуспешного ответа (HTTP CODE 400)

{
  "message": "The given data was invalid.",
  "errors": {
    ...
  }
}

После получения url переадресуйте клиента по ссылке.

Возможные значения payment_status, смотрите в документации "Статус платежа".

предупреждение

Если вы передали notification_endpoint_id или notification_endpoint_url, то вы получите уведомление о смене статуса оплаты

Коды банков для депозита

service	customer_code
payment_card_bdt_hpp	nagad
	bkash
	rocket