Payment solution VN 1

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

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

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_vnd_hpp qr_code_vnd_hpp e_wallet_vnd_hpp local_bank_transfer_vnd_hpp
customer_ip*	ip	Ip адрес плательщика
customer_code*	string (100)	Deposit Bank Code
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_vnd_hpp	ACB	Asia Commercial Bank
	AGB	Agribank
	BIDV	Bank for Investment and Development of Vietnam
	DAB	DongA Bank
	EXIM	Eximbank Vietnam
	HDB	HDB Bank
	MB	Military Commercial Joint Stock Bank
	MTMB	Maritime Bank
	OCB	Orient Commercial Joint Stock Bank
	SACOM	Sacombank
	TCB	Techcombank
	TPB	Tien Phong Bank
	VCB	Vietcombank
	VIB	Vietnam International Bank
	VPB	VP Bank
	VTB	Vietinbank
qr_code_vnd_hpp	VIETQR	VietQRpay
e_wallet_vnd_hpp	VIETQRMOMO	VietQR MOMO
	VIETQRZALO	VietQR Zalo Pay
	VIETQRVIETTEL	VietQR Viettel Pay
local_bank_transfer_vnd_hpp	VSTB	VND Semi Transfer Bank
	VCBLBT	Vietcom Bank Local Bank Transfer
	DABLBT	Donga 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_vnd
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_vnd	ABCJS	An Binh Commercial Join Stock Bank
	CITIV	Citibank Vietnam
	HDB	HoChiMinh City Development Joint Stock Commercial Bank
	HSBCV	HSBC Vietnam
	NAMA	Nam A Commercial Joint Stock Bank (NamaBank)
	PBBV	Public Bank Vietnam
	PVCB	PVcomBank
	SCBV	Standard Chartered Bank Vietnam
	SGCB	Saigon Commercial Bank (Ngân hàng TMCP Sài Gòn)
	SHBV	Shinhan Bank Vietnam
	SHCB	Saigon-Hanoi Commercial Joint Stock Bank
	VCPTB	Viet Capital Bank (Ngan Hang Ban Viet)
	OCB	Orient Commercial Joint Stock Bank
	DBVN	Deutsche Bank
	WBVN	Woori Bank VN
	SEAVN	SeAbank
	LVPB	LienVietPostBank
	VAB	VIET A BANK
	BAB	Bac A Commercial Joint Stock Bank
	NCB	National Citizen Bank
	KLB	Kien Long Commercial Joint Stock Bank
	VB	Vietbank
	CB	Vietnam Construction Bank-CB
	BSHB	SHB Bank
	ABB	AB BANK
	PGB	PG Bank
	OCEANB	Ocean Bank Viet Nam