Payment solution TH 2

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

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

URL	POST https://api-merchant.alikassa.com/v1/payment
HEADER
Content-Type	application/json
Account	Your account uuid, you can find in Accounts https://merchant.alikassa.com/cabinet/resources/project-accounts
Sign	Request signature

Link https://merchant.alikassa.com/cabinet/form/setting-api-certs generate "API certificate for payment", save the archive, unpack

password.txt
private.pem
public.pem

We keep only public.pem for signature verification.

Wrap all POST data in json (in the same order) and sign

$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);

Pass the received $sign in the Sign header. You can find a sample code at the end of the document.

* - Required fields

Name	Type	Description
amount*	decimal (11.2)	Amount
order_id*	string (128)	Your id must be unique
service*	string (100)	online_banking_thb_hpp qr_code_thb_hpp local_bank_transfer_thb_hpp
customer_ip*	ip	Payer's IP address
customer_code*	string (100)	Deposit Bank Code
success_redirect_id	int	Id of redirect upon successful payment
fail_redirect_id	int	Id of redirect in case of unsuccessful payment
notification_endpoint_id	int	Notification id
success_redirect_url	string\|max:255	Link to redirect after successful payment
fail_redirect_url	string\|max:255	Link to redirect after unsuccessful payment
notification_endpoint_url	string\|max:255	Link to send a callback after the statuses are finalized

Response

Name	Description
url	Link to payment
payment_status	Payment status wait — in the process of payment
id	AliKassa payment id
uuid	AliKassa payment uuid
success_redirect_url	Ссылка на вашу страницу, для редирека клиента после успешной оплаты

When creating, always wait, check the payment status via the API or wait for a notification!

Example of a successful HTTP CODE 200 response:

{
    "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
}

An example of an unsuccessful HTTP CODE 400 response:

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

After receiving the url, redirect the client to the link.

Possible values of payment_status, see the documentation "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	Your account uuid, you can find in Accounts https://merchant.alikassa.com/cabinet/resources/project-accounts
Sign	Request signature

* - Required fields

Name	Type	Description
amount*	decimal (11.2)	Amount
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	Notification id
notification_endpoint_url	string\|max:255	Link to send a callback after the statuses are finalized

Response

Name	Description
id	AliKassa payment id
payment_status	Payment status wait — in the process of payment

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