WebHook тестілеу

Тестілеу

post
https://api.cryptomus.com/v1/test-webhook/payment
Еліктеу

Webhook деректер массивінен қолтаңбаны растау үшін, төлем API пернесін пайдаланыңыз.

Сіз webhooks дұрыс қабылдап, қолтаңбаны тексере алатындығыңызға көз жеткізу үшін, төлемдер үшін webhooks тестілеу әдісін қолдануыңыз керек.
Назар аударыңыз, деректер дерекқорға сақталмайды, ал webhook арқылы алынған барлық деректер тек қолтаңбаның дұрыстығын тексеру және осы массивті бізден алу үшін тестілеу мақсатында массивте сақталады.

Қолданыстағы шотпен webhook тестілеу үшін оның uuid немесе тапсырыс ID көрсетіңіз. Егер бұл параметрлер көрсетілмесе, webhook тестілік шотпен жіберіледі.

Өтініш

Сұрау параметрлері

ЕсімПараметр түріӘдепкі мәнАнықтама
url_callback*stringmin:6max:150urlURL, оған төлем күйі бар webhooks жіберіледі
currency*stringШот-фактураның валюталық коды
network*stringШот-фактура желісінің коды
uuidstringuuidКездейсоқ Uuid жолышот-фактураның uuid
order_idstringmin:1max:32alpha_dashКездейсоқ жолШот-фактураның идентификаторы
status*stringpaidТөлем мәртебесіҚол жетімді опциялар:processcheckpaidpaid_overfailwrong_amountcancelsystem_failrefund_processrefund_failrefund_paid

Параметр түрі

stringmin:6max:150url

Анықтама

URL, оған төлем күйі бар webhooks жіберіледі

Параметр түрі

string

Анықтама

Шот-фактураның валюталық коды

Параметр түрі

string

Анықтама

Шот-фактура желісінің коды

Параметр түрі

stringuuid

Анықтама

шот-фактураның uuid

Параметр түрі

stringmin:1max:32alpha_dash

Анықтама

Шот-фактураның идентификаторы

Параметр түрі

string

Анықтама

Төлем мәртебесіҚол жетімді опциялар:- process- check- paid- paid_over- fail- wrong_amount- cancel- system_fail- refund_process- refund_fail- refund_paid

* - Міндетті параметр

Егер сіз екеуін де, есептік жазбаны UUID арқылы анықтайтын UUID немесе TEST_ID параметрлерінің бірін өткізуге болады

Мысал сұрау


curl https://api.cryptomus.com/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"
}'
Еліктеу

Жауап

Жауаптың мысалы


1{
2  "state": 0,
3  "result": []
4}
Еліктеу

Төлемді тексеру

post
https://api.cryptomus.com/v1/test-webhook/payout
Еліктеу

Webhook деректер массивінен қолтаңбаны растау үшін, төлем API пернесін пайдаланыңыз.

Өтініш

Сұрау параметрлері

ЕсімПараметр түріӘдепкі мәнАнықтама
url_callback*stringmin:6max:150urlURL, оған төлем күйі бар webhooks жіберіледі
currency*stringТөлем валютасының коды
network*stringТөлем желісінің коды
uuidstringuuidКездейсоқ Uuid жолыТөлемнің ууидері
order_idstringmin:1max:32alpha_dashКездейсоқ жолТөлемнің жеке куәлігі
status*stringpaidТөлем мәртебесіҚол жетімді опциялар:processcheckpaidfailcancelsystem_fail

Параметр түрі

stringmin:6max:150url

Анықтама

URL, оған төлем күйі бар webhooks жіберіледі

Параметр түрі

string

Анықтама

Төлем валютасының коды

Параметр түрі

string

Анықтама

Төлем желісінің коды

Параметр түрі

stringuuid

Анықтама

Төлемнің ууидері

Параметр түрі

stringmin:1max:32alpha_dash

Анықтама

Төлемнің жеке куәлігі

Параметр түрі

string

Анықтама

Төлем мәртебесіҚол жетімді опциялар:- process- check- paid- fail- cancel- system_fail

* - Міндетті параметр

Егер сіз екеуін де, есептік жазбаны UUID арқылы анықтайтын UUID немесе TEST_ID параметрлерінің бірін өткізуге болады

Мысал сұрау


curl https://api.cryptomus.com/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"
}'
Еліктеу

Жауап

Жауаптың мысалы


1{
2  "state": 0,
3  "result": []
4}
Еліктеу

Әмиянды тексеру

post
https://api.cryptomus.com/v1/test-webhook/wallet
Еліктеу

Webhook деректер массивінен қолтаңбаны растау үшін, төлем API пернесін пайдаланыңыз.

Өтініш

Сұрау параметрлері

ЕсімПараметр түріӘдепкі мәнАнықтама
url_callback*stringmin:6max:150urlURL, оған төлем күйі бар webhooks жіберіледі
currency*stringТөлем валютасының коды
network*stringТөлем желісінің коды
uuidstringuuidКездейсоқ Uuid жолыІскери әмиянның uuid
order_idstringmin:1max:32alpha_dashКездейсоқ жолШот-фактураның идентификаторы
status*stringpaidТөлем мәртебесіҚол жетімді опциялар:processcheckpaidpaid_overfailwrong_amountcancelsystem_failrefund_processrefund_failrefund_paid

Параметр түрі

stringmin:6max:150url

Анықтама

URL, оған төлем күйі бар webhooks жіберіледі

Параметр түрі

string

Анықтама

Төлем валютасының коды

Параметр түрі

string

Анықтама

Төлем желісінің коды

Параметр түрі

stringuuid

Анықтама

Іскери әмиянның uuid

Параметр түрі

stringmin:1max:32alpha_dash

Анықтама

Шот-фактураның идентификаторы

Параметр түрі

string

Анықтама

Төлем мәртебесіҚол жетімді опциялар:- process- check- paid- paid_over- fail- wrong_amount- cancel- system_fail- refund_process- refund_fail- refund_paid

* - Міндетті параметр

Мысал сұрау


curl https://api.cryptomus.com/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"
}'
Еліктеу

Жауап

Жауаптың мысалы


1{
2  "state": 0,
3  "result": []
4}
Еліктеу

Мүмкін қателер

Тексеру қателері

код : 422

Мысал жауаптары:

Егер сіз uuid order_id және шот-фактура / Төлем табылмаса:


1{
2    "state": 1,
3    "message": "Not found payment"
4}
Еліктеу


1{
2    "state": 1,
3    "message": "Not found payout"
4}
Еліктеу


1{
2    "state": 1,
3    "message": "Not found wallet"
4}
Еліктеу

Егер сіз қажетті параметрлерді бермесеңіз:


1{
2	"state": 1,
3	"errors": {
4		"currency": ["validation.required"]
5	}
6}
Еліктеу

Егер ұсынылған валюта мен желі крипто болмаса немесе қолдау көрсетілмесе:


1{
2    "state": 1,
3    "message": "Payment service not found"
4}
Еліктеу


1{
2    "state": 1,
3    "message": "Payout service not found"
4}
Еліктеу