Webhookni sinash

Asosiy

To'lovlar

Test maqsadli webhook

Sinov to'lovi

post

https://api.heleket.com/v1/test-webhook/payment

Copy

Imzoni webhook ma'lumotlar massividan tasdiqlash uchun, to'lov API kalitidan foydalaning.

Sizning webhooks-ni to'g'ri qabul qilganingizga va imzoni tasdiqlay olishingizga ishonch hosil qilish uchun, to'lov uchun webhooks-ni sinovdan o'tkazish uchun ushbu usulni ishlatishingiz kerak.
Iltimos, shuni yodda tutingki, hech qanday ma'lumotlar ma'lumotlar bazasiga saqlanmaydi va webhook orqali olingan barcha ma'lumotlar faqat tekshirish maqsadida massivda saqlanadi, bu esa imzo to'g'riligini ta'minlash va bizdan ushbu massivni olishni sinab ko'rish uchun zarur.

Mavjud hisob-faktura bilan webhookni sinab ko'rish uchun, iltimos, uning uuid yoki buyurtma ID raqamini taqdim eting. Agar ushbu parametrlar taqdim etilmasa, webhook test hisob-fakturasi bilan yuboriladi.

Talab qilmoq

So'rov parametrlari

Ism	Parametr turi	Standart qiymat	Ta'rif
url_callback*	stringmin:6max:150url		To'lov holati bilan qaysi webhook yuboriladi
currency*	string		Hisob-faktura valyuta kodi
network*	string		Hisob-fakturaning tarmog'i kodi
uuid	stringuuid	Tasodifiy uuid strasi	Hisob-fakturaning uuid
order_id	stringmin:1max:32alpha_dash	Tasodifiy satr	Hisob-fakturaning buyurtma identifikatori
status*	string	paid	To'lov holatiMavjud variantlar:• process• check• paid• paid_over• fail• wrong_amount• cancel• system_fail• refund_process• refund_fail• refund_paid• locked

Parametr turi stringmin:6max:150url Ta'rif To'lov holati bilan qaysi webhook yuboriladi
Parametr turi string Ta'rif Hisob-faktura valyuta kodi
Parametr turi string Ta'rif Hisob-fakturaning tarmog'i kodi
Parametr turi stringuuid Ta'rif Hisob-fakturaning uuid
Parametr turi stringmin:1max:32alpha_dash Ta'rif Hisob-fakturaning buyurtma identifikatori
Parametr turi string Ta'rif To'lov holatiMavjud variantlar:- process- check- paid- paid_over- fail- wrong_amount- cancel- system_fail- refund_process- refund_fail- refund_paid- locked

* - Majburiy parametr

Siz ikkalasini ham olsangiz, uuid yoki buyurtma_id parametrlaridan birini o'tkazishingiz mumkin, bu hisob UUID tomonidan aniqlanadi

Misolga misol


curl http://api.merchant.heleket.local/v1/test-webhook/payment \
-X POST \
-H 'merchant: 860166ce-478c-4087-9813-55cfb6c34580' \
-H 'sign: a466b82fad9415cdbf5f47802b8d376c' \
-H 'Content-Type: application/json' \
-d '{
	"uuid": "e1830f1b-50fc-432e-80ec-15b58ccac867",
	"currency": "ETH",
	"url_callback": "https://your.site/callback",
	"network": "eth",
	"status": "paid"
}'

Copy

Javob

Javob namunasi


1{
2  "state": 0,
3  "result": []
4}

Copy

Sinov to'lovi

post

https://api.heleket.com/v1/test-webhook/payout

Copy

Imzoni webhook ma'lumotlar massividan tasdiqlash uchun, to'lov API kalitidan foydalaning.

Talab qilmoq

So'rov parametrlari

Ism	Parametr turi	Standart qiymat	Ta'rif
url_callback*	stringmin:6max:150url		To'lov holati bilan qaysi webhook yuboriladi
currency*	string		To'lov valyutasi kodi
network*	string		To'lov tarmog'i kodi
uuid	stringuuid	Tasodifiy uuid strasi	To'lovning UUID
order_id	stringmin:1max:32alpha_dash	Tasodifiy satr	To'lovning buyurtma identifikatori
status*	string	paid	To'lov holatiMavjud variantlar:• process• check• paid• fail• cancel• system_fail

Parametr turi stringmin:6max:150url Ta'rif To'lov holati bilan qaysi webhook yuboriladi
Parametr turi string Ta'rif To'lov valyutasi kodi
Parametr turi string Ta'rif To'lov tarmog'i kodi
Parametr turi stringuuid Ta'rif To'lovning UUID
Parametr turi stringmin:1max:32alpha_dash Ta'rif To'lovning buyurtma identifikatori
Parametr turi string Ta'rif To'lov holatiMavjud variantlar:- process- check- paid- fail- cancel- system_fail

* - Majburiy parametr

Siz ikkalasini ham olsangiz, uuid yoki buyurtma_id parametrlaridan birini o'tkazishingiz mumkin, bu hisob UUID tomonidan aniqlanadi

Misolga misol


curl http://api.merchant.heleket.local/v1/test-webhook/payout \
-X POST -H 'merchant: 860166ce-478c-4087-9813-55cfb6c34580' \
-H 'sign: a466b82fad9415cdbf5f47802b8d376c' \
-H 'Content-Type: application/json' \
-d '{
	"uuid": "e1830f1b-50fc-432e-80ec-15b58ccac867",
	"currency": "ETH",
	"url_callback": "https://your.site/callback",
	"network": "eth",
	"status": "paid"
}'

Copy

Javob

Javob namunasi


1{
2  "state": 0,
3  "result": []
4}

Copy

Sinov hamyonini sinovdan o'tkazish

post

https://api.heleket.com/v1/test-webhook/wallet

Copy

Imzoni webhook ma'lumotlar massividan tasdiqlash uchun, to'lov API kalitidan foydalaning.

Talab qilmoq

So'rov parametrlari

Ism	Parametr turi	Standart qiymat	Ta'rif
url_callback*	stringmin:6max:150url		To'lov holati bilan qaysi webhook yuboriladi
currency*	string		To'lov valyutasi kodi
network*	string		To'lov tarmoq kodi
uuid	stringuuid	Tasodifiy uuid strasi	Business hamyonning UUIDorder_id bo'lmasa talab qilinadi
order_id	stringmin:1max:32alpha_dash	Tasodifiy satr	Hisob-fakturaning buyurtma identifikatoriAgar uuid yo'q bo'lsa, talab qilinadi
status*	string	paid	To'lov holatiMavjud variantlar:• process• check• paid• paid_over• fail• wrong_amount• cancel• system_fail• refund_process• refund_fail• refund_paid• locked

Parametr turi stringmin:6max:150url Ta'rif To'lov holati bilan qaysi webhook yuboriladi
Parametr turi string Ta'rif To'lov valyutasi kodi
Parametr turi string Ta'rif To'lov tarmoq kodi
Parametr turi stringuuid Ta'rif Business hamyonning UUIDorder_id bo'lmasa talab qilinadi
Parametr turi stringmin:1max:32alpha_dash Ta'rif Hisob-fakturaning buyurtma identifikatoriAgar uuid yo'q bo'lsa, talab qilinadi
Parametr turi string Ta'rif To'lov holatiMavjud variantlar:- process- check- paid- paid_over- fail- wrong_amount- cancel- system_fail- refund_process- refund_fail- refund_paid- locked

* - Majburiy parametr

Misolga misol


curl http://api.merchant.heleket.local/v1/test-webhook/wallet \
-X POST -H 'merchant: 860166ce-478c-4087-9813-55cfb6c34580' \
-H 'sign: a466b82fad9415cdbf5f47802b8d376c' \
-H 'Content-Type: application/json' \
-d '{
	"uuid": "e1830f1b-50fc-432e-80ec-15b58ccac867",
	"currency": "ETH",
	"url_callback": "https://your.site/callback",
	"network": "eth",
	"status": "paid"
}'

Copy

Javob

Javob namunasi


1{
2  "state": 0,
3  "result": []
4}

Copy

Mumkin bo'lgan xatolar

Tasdiqlash xatolari

kod : 422

Misol javoblar:

Agar siz uuid yoki order_id va faktura / statik hamyon / to'lov topilmasa:


1{
2    "state": 1,
3    "message": "Not found payment"
4}

Copy


1{
2    "state": 1,
3    "message": "Not found payout"
4}

Copy


1{
2    "state": 1,
3    "message": "Not found wallet"
4}

Copy

Agar siz kerakli parametrlardan o'tmasangiz:


1{
2	"state": 1,
3	"errors": {
4		"currency": ["validation.required"]
5	}
6}

Copy

Agar taqdim etilgan valyuta va tarmoq kripto bo'lmasa yoki qo'llab-quvvatlanmasa:


1{
2    "state": 1,
3    "message": "Payment service not found"
4}

Copy


1{
2    "state": 1,
3    "message": "Payout service not found"
4}

Copy