Payment solution ID 2

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

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

URL	POST https://api-merchant.alikassa.com/v1/payment
HEADER
Content-Type	application/json
Account	Ваш uuid счета (вы можете найти в разделе "Счета") https://merchant.alikassa.com/cabinet/resources/project-accounts
Sign	Подпись запроса

По ссылке 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('Error cert.');
}

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

Полученную подпись $sign передайте в заголовке "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)	Deposit Bank Code
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	Ссылка на вашу страницу, для редирека клиента после успешной оплаты

При создании всегда платежа payment_status: 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, то вы получите уведомление о смене статуса оплаты

Deposit Bank Code

service	customer_code	bank name
online_banking_idr_hpp	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	QRIS	QRIS
	DANAQRIS	DANA QRIS
	GOPAYQRIS	GO PAY QRIS
	LINKAJAQRIS	LINK AJA QRIS
	OVOQRIS	OVO QRIS
	SHOPEEQRIS	Shopee Pay QRIS
virtual_account_idr_hpp	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	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	POST https://api-merchant.alikassa.com/v1/payout
HEADER
Content-Type	application/json
Account	Ваш uuid счета (вы можете найти в разделе "Счета") https://merchant.alikassa.com/cabinet/resources/project-accounts
Sign	Подпись запроса

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

Название	Тип	Описание
amount*	decimal (11.2)	Сумма
order_id*	string (128)	"1234"
service*	string (100)	payment_card_idr
number*	string (100)	Номер счета получателя
customer_code*	string (100)	Payout Bank Code
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 — в процессе оплаты

Payout Bank Code

service	customer_code	bank name
payment_card_idr	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 (under maintenance)
	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)