Платёжное решение ID 2

Обзор

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

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

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

Получите:

password.txt
private.pem
public.pem

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

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

$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('SHA1');
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()
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.SHA1())
sign = base64.b64encode(signature).decode()

import java.nio.file.Files;
import java.nio.file.Paths;
import java.security.Signature;
import java.util.Base64;
import org.bouncycastle.openssl.PEMEncryptedKeyPair;
import org.bouncycastle.openssl.PEMParser;
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("SHA1withRSA");
sig.initSign(privateKey);
sig.update(dataBytes);
String sign = Base64.getEncoder().encodeToString(sig.sign());

import (
    "crypto"
    "crypto/rand"
    "crypto/rsa"
    "crypto/sha1"
    "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 := sha1.Sum(dataBytes)
sigBytes, _ := rsa.SignPKCS1v15(rand.Reader, priv, crypto.SHA1, 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)	online_banking_idr_hpp qr_code_idr_hpp virtual_account_idr_hpp local_bank_transfer_idr_hpp
customer_ip*	ip	IP адрес плательщика
customer_code*	string (100)	Код банка для пополнения
customer_first_name*	string	Имя плательщика
customer_last_name*	string	Фамилия плательщика
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 переадресуйте клиента по ссылке.

Важно

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

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

online_banking_idr_hpp

customer_code	Название банка
BCA	Bank Central Asia
BNI	Bank Negara Indonesia
BRI	Bank Rakyat Indonesia
CIMBN	CIMB Niaga
MDR	Mandiri Bank
PMTB	Permata Bank
PANIN	Panin Bank

qr_code_idr_hpp

customer_code	Название банка
QRIS	QRIS
DANAQRIS	DANA QRIS
GOPAYQRIS	GO PAY QRIS
LINKAJAQRIS	LINK AJA QRIS
OVOQRIS	OVO QRIS
SHOPEEQRIS	Shopee Pay QRIS

virtual_account_idr_hpp

customer_code	Название банка
BCAVA	BCA Virtual Account
BNIVA	BNI Virtual Account
BRIVA	BRI Virtual Account
CIMBNVA	CIMBN Virtual Account
MBBIVA	MBBI Virtual Account
MDRVA	MDR Virtual Account
PMTBVA	PMTB Virtual Account
PANINVA	PANIN Virtual Account
BDIVA	BDI Virtual Account

local_bank_transfer_idr_hpp

customer_code	Название банка
BCALBT	BCA Bank Local Bank Transfer
BNILBT	BNI Bank (Local Bank Transfer)
BRILBT	BRI Bank (Local Bank Transfer)
MDRLBT	Mandiri Bank (Local Bank Transfer)

Создание выплат

URL

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

Заголовки

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

Параметры

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

Название	Тип	Описание
amount*	decimal (11.2)	Сумма
order_id*	string (128)	Ваш id (должен быть уникальный) (пример: "1234")
service*	string (100)	payment_card_idr
number*	string (100)	Номер счета получателя
customer_code*	string (100)	Код банка для выплаты
customer_first_name*	string (100)	Имя плательщика
customer_last_name*	string (100)	Фамилия плательщика
notification_endpoint_id	int	Id уведомления
notification_endpoint_url	string\|max:255	Ссылка для отправки колбека после финализации статусов

Ответ

Название	Описание
id	Id платежа AliKassa
payment_status	Статус платежа wait — в процессе оплаты

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

payment_card_idr

customer_code	Название банка
PMTB	Permata Bank
BCASB	BCA Syariah Bank (enterprise)
BMI	Bank Mega Indonesia
BRISB	BRI Syariah Bank (enterprise)
BSM	Bank Sinarmas
BTN	Bank Tabungan Negara
BTPN	Bank Tabungan Pensiunan Nasional
OCBCN	Bank OCBC NISP
MDRSB	Mandiri Syariah Bank
PNBN	PT. Bank Pan Indonesia
UOBI	UOB Indonesia
BSI	Bank Syariah Indonesia (на техническом обслуживании)
PTBC	PT. Bank Commonwealth
HSBCI	HSBC Indonesia
PANIN	Panin Bank
DBSI	BANK DBS
HANAI	Hanabank Indonesia
MNC	Bank MNC Internasional
BKAL	Bank Kalteng
ALLOB	ALLO BANK
SEABANK	SeaBank
SUMUT	Bank Sumut
BMLI	Bank Muamalat
BCAD	BCA Digital
BJB	Bank Jabar (BJB)

Важно

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

Обзор​

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

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

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

URL​

Заголовки​

Параметры​

Ответ​

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

Пример ошибки ответа (HTTP CODE 400)​

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

online_banking_idr_hpp​

qr_code_idr_hpp​

virtual_account_idr_hpp​

local_bank_transfer_idr_hpp​

Создание выплат​

URL​

Заголовки​

Параметры​

Ответ​

Коды банков для выплат​

payment_card_idr​

Обзор

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

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

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

URL

Заголовки

Параметры

Ответ

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

Пример ошибки ответа (HTTP CODE 400)

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

online_banking_idr_hpp

qr_code_idr_hpp

virtual_account_idr_hpp

local_bank_transfer_idr_hpp

Создание выплат

URL

Заголовки

Параметры

Ответ

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

payment_card_idr