Payment solution TH 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_thb_hpp qr_code_thb_hpp local_bank_transfer_thb_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_thb_hpp	BBL	Bangkok Bank
	BOA	BBank of Ayudhya (Krungsri)
	KKR	Karsikorn Bank (K-Bank)
	KNK	Kiatnakin Bank
	KTB	Krung Thai Bank
	SCB	Siam Commercial Bank
	TMB	TMBThanachart Bank(TTB)
qr_code_thb_hpp	PPTP	Promptpay
local_bank_transfer_thb_hpp	TSTB	Thai Semi Transfer Bank
	BBLLBT	BBL Local Bank Transfer
	BOALBT	BOA Local Bank Transfer
	KKRLBT	KKR Local Bank Transfer
	SCBLBT	SCB Local Bank Transfer
	TMBLBT	TMB 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_thb
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_thb	GSB	Government Savings Bank
	HSBCT	HSBC Thailand
	ICBCT	Industrial and Commercial Bank of China (Thai)
	SCBT	Standard Chartered Thailand
	BAAC	BANK FOR AGRICULTURE AND AGRICULTURAL COOPERATIVES
	BOT	Bank of Thailand
	DBTB	Deutsche Bank
	MHCB	Mizuho Bank Bangkok Branch
	UOBT	UOB Thai
	BOAS	Bank of Asia
	LHB	LH Bank (Land and House Bank)
	GHB	GOVERNMENT HOUSING BANK
	TCRB	THAI CREDIT RETAIL BANK
	TISCO	TISCO Bank