Testowanie Webhook

Testowanie płatności

post https://api.cryptomus.com/v1/test-webhook/payment Kopia

Aby potwierdzić podpis z tablicy danych WebHook, użyj klucza API płatności.

Aby upewnić się, że poprawnie odbierasz webhooks i możesz zweryfikować podpis, powinieneś użyć tej metody do testowania webhooków dla płatności.
Należy pamiętać, że w bazie danych nie zapisano żadnych danych, a wszelkie dane otrzymane w Webhook są przechowywane tylko w tablicy do celów testowania, aby zapewnić poprawność podpisu i przetestować od nas pobieranie tej tablicy.

Aby przetestować webhook z istniejącą fakturą, proszę podać jej uuid lub ID zamówienia. Jeśli te parametry nie zostaną podane, webhook zostanie wysłany z fakturą testową.

Wniosek

Parametry zapytania

NazwaTyp parametruDomyślna wartośćDefinicja
url_callback*stringmin:6max:150url-URL, do którego webhooks ze statusem płatności zostaną wysłane
currency*string-Kod waluty faktury
network*string-Kod sieciowy faktury
uuidstringuuidlosowy ciąg UUIDuuid faktury
order_idstringmin:1max:32alpha_dashLosowy ciągZamów identyfikator faktury
status*stringpaidStatus płatnościDostępne opcje:• process• check• paid• paid_over• fail• wrong_amount• cancel• system_fail• refund_process• refund_fail• refund_paid

Typ parametru

stringmin:6max:150url

Definicja

URL, do którego webhooks ze statusem płatności zostaną wysłane

Typ parametru

string

Definicja

Kod waluty faktury

Typ parametru

string

Definicja

Kod sieciowy faktury

Typ parametru

stringuuid

Domyślna wartość

losowy ciąg UUID

Definicja

uuid faktury

Typ parametru

stringmin:1max:32alpha_dash

Domyślna wartość

Losowy ciąg

Definicja

Zamów identyfikator faktury

Typ parametru

string

Domyślna wartość

paid

Definicja

Status płatnościDostępne opcje:- process- check- paid- paid_over- fail- wrong_amount- cancel- system_fail- refund_process- refund_fail- refund_paid

* - obowiązkowy parametr

Możesz przejść jeden z parametrów UUID lub Order_ID, jeśli zdasz oba, konto zostanie zidentyfikowane przez UUID

Przykład żądania


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"
}'
Kopia

Odpowiedź

Przykład odpowiedzi


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

Testowanie wypłaty

post https://api.cryptomus.com/v1/test-webhook/payout Kopia

Aby potwierdzić podpis z tablicy danych WebHook, użyj klucza API płatności.

Wniosek

Parametry zapytania

NazwaTyp parametruDomyślna wartośćDefinicja
url_callback*stringmin:6max:150url-URL, do którego webhooks ze statusem płatności zostaną wysłane
currency*string-Kod waluty wypłaty
network*string-Kod sieciowy wypłat
uuidstringuuidlosowy ciąg UUIDuuid wypłaty
order_idstringmin:1max:32alpha_dashLosowy ciągIdentyfikator zamówienia wypłaty
status*stringpaidStatus wypłatyDostępne opcje:• process• check• paid• fail• cancel• system_fail

Typ parametru

stringmin:6max:150url

Definicja

URL, do którego webhooks ze statusem płatności zostaną wysłane

Typ parametru

string

Definicja

Kod waluty wypłaty

Typ parametru

string

Definicja

Kod sieciowy wypłat

Typ parametru

stringuuid

Domyślna wartość

losowy ciąg UUID

Definicja

uuid wypłaty

Typ parametru

stringmin:1max:32alpha_dash

Domyślna wartość

Losowy ciąg

Definicja

Identyfikator zamówienia wypłaty

Typ parametru

string

Domyślna wartość

paid

Definicja

Status wypłatyDostępne opcje:- process- check- paid- fail- cancel- system_fail

* - obowiązkowy parametr

Możesz przejść jeden z parametrów UUID lub Order_ID, jeśli zdasz oba, konto zostanie zidentyfikowane przez UUID

Przykład żądania


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"
}'
Kopia

Odpowiedź

Przykład odpowiedzi


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

Testowanie portfela

post https://api.cryptomus.com/v1/test-webhook/wallet Kopia

Aby potwierdzić podpis z tablicy danych WebHook, użyj klucza API płatności.

Wniosek

Parametry zapytania

NazwaTyp parametruDomyślna wartośćDefinicja
url_callback*stringmin:6max:150url-URL, do którego webhooks ze statusem płatności zostaną wysłane
currency*string-Kod waluty płatności
network*string-Kod sieci płatności
uuidstringuuidlosowy ciąg UUIDUuid of Business Portfere
order_idstringmin:1max:32alpha_dashLosowy ciągZamów identyfikator faktury
status*stringpaidStatus płatnościDostępne opcje:• process• check• paid• paid_over• fail• wrong_amount• cancel• system_fail• refund_process• refund_fail• refund_paid

Typ parametru

stringmin:6max:150url

Definicja

URL, do którego webhooks ze statusem płatności zostaną wysłane

Typ parametru

string

Definicja

Kod waluty płatności

Typ parametru

string

Definicja

Kod sieci płatności

Typ parametru

stringuuid

Domyślna wartość

losowy ciąg UUID

Definicja

Uuid of Business Portfere

Typ parametru

stringmin:1max:32alpha_dash

Domyślna wartość

Losowy ciąg

Definicja

Zamów identyfikator faktury

Typ parametru

string

Domyślna wartość

paid

Definicja

Status płatnościDostępne opcje:- process- check- paid- paid_over- fail- wrong_amount- cancel- system_fail- refund_process- refund_fail- refund_paid

* - obowiązkowy parametr

Przykład żądania


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"
}'
Kopia

Odpowiedź

Przykład odpowiedzi


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

Możliwe błędy

Błędy walidacji

kod : 422

przykładowe odpowiedzi:

Jeśli zdasz uuid lub order_id i faktura/portfel statyczny/wypłata nie zostanie znaleziony:


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


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


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

Jeśli nie zdasz wymaganych parametrów:


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

Jeśli dostarczona waluta i sieć nie są kryptowalutami lub nie są obsługiwane:


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


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