Menguji webhook

Menguji pembayaran

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

Untuk memvalidasi tanda tangan dari susunan data webhook, gunakan kunci API pembayaran.

Untuk memastikan bahwa Anda menerima webhook dengan benar dan dapat memvalidasi tanda tangan, Anda harus menggunakan metode ini untuk menguji webhook untuk pembayaran.
Harap dicatat bahwa tidak ada data yang disimpan ke database, dan data apa pun yang diterima di webhook hanya disimpan dalam array untuk tujuan pengujian guna memastikan kebenaran tanda tangan dan untuk menguji pengambilan array ini dari kami.

Untuk menguji webhook dengan faktur yang sudah ada, harap berikan uuid atau ID pesanannya. Jika parameter ini tidak diberikan, webhook akan dikirim dengan faktur uji.

Meminta

Parameter kueri

NamaJenis parameterNilai defaultDefinisi
url_callback*stringmin:6max:150url-URL tempat webhook dengan status pembayaran akan dikirim
currency*string-Kode mata uang faktur
network*string-Kode jaringan faktur
uuidstringuuidstring uuid acakuuid dari faktur
order_idstringmin:1max:32alpha_dashstring acakID pesanan faktur
status*stringpaidStatus pembayaranPilihan yang tersedia:processcheckpaidpaid_overfailwrong_amountcancelsystem_failrefund_processrefund_failrefund_paid

Jenis parameter

stringmin:6max:150url

Definisi

URL tempat webhook dengan status pembayaran akan dikirim

Jenis parameter

string

Definisi

Kode mata uang faktur

Jenis parameter

string

Definisi

Kode jaringan faktur

Jenis parameter

stringuuid

Nilai default

string uuid acak

Definisi

uuid dari faktur

Jenis parameter

stringmin:1max:32alpha_dash

Nilai default

string acak

Definisi

ID pesanan faktur

Jenis parameter

string

Nilai default

paid

Definisi

Status pembayaranPilihan yang tersedia:- process- check- paid- paid_over- fail- wrong_amount- cancel- system_fail- refund_process- refund_fail- refund_paid

* - parameter wajib

Anda dapat meneruskan salah satu parameter uuid atau order_id, jika Anda meneruskan keduanya, akun akan diidentifikasi oleh uuid

Contoh permintaan


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

Tanggapan

Contoh respons


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

Menguji pembayaran

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

Untuk memvalidasi tanda tangan dari susunan data webhook, gunakan kunci API pembayaran.

Meminta

Parameter kueri

NamaJenis parameterNilai defaultDefinisi
url_callback*stringmin:6max:150url-URL tempat webhook dengan status pembayaran akan dikirim
currency*string-Kode mata uang pembayaran
network*string-Kode jaringan pembayaran
uuidstringuuidstring uuid acakuuid pembayaran
order_idstringmin:1max:32alpha_dashstring acakID pesanan pembayaran
status*stringpaidStatus pembayaranPilihan yang tersedia:processcheckpaidfailcancelsystem_fail

Jenis parameter

stringmin:6max:150url

Definisi

URL tempat webhook dengan status pembayaran akan dikirim

Jenis parameter

string

Definisi

Kode mata uang pembayaran

Jenis parameter

string

Definisi

Kode jaringan pembayaran

Jenis parameter

stringuuid

Nilai default

string uuid acak

Definisi

uuid pembayaran

Jenis parameter

stringmin:1max:32alpha_dash

Nilai default

string acak

Definisi

ID pesanan pembayaran

Jenis parameter

string

Nilai default

paid

Definisi

Status pembayaranPilihan yang tersedia:- process- check- paid- fail- cancel- system_fail

* - parameter wajib

Anda dapat meneruskan salah satu parameter uuid atau order_id, jika Anda meneruskan keduanya, akun akan diidentifikasi oleh uuid

Contoh permintaan


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

Tanggapan

Contoh respons


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

Menguji dompet

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

Untuk memvalidasi tanda tangan dari susunan data webhook, gunakan kunci API pembayaran.

Meminta

Parameter kueri

NamaJenis parameterNilai defaultDefinisi
url_callback*stringmin:6max:150url-URL tempat webhook dengan status pembayaran akan dikirim
currency*string-Kode mata uang pembayaran
network*string-Kode jaringan pembayaran
uuidstringuuidstring uuid acakuuid dompet bisnis
order_idstringmin:1max:32alpha_dashstring acakID pesanan faktur
status*stringpaidStatus pembayaranPilihan yang tersedia:processcheckpaidpaid_overfailwrong_amountcancelsystem_failrefund_processrefund_failrefund_paid

Jenis parameter

stringmin:6max:150url

Definisi

URL tempat webhook dengan status pembayaran akan dikirim

Jenis parameter

string

Definisi

Kode mata uang pembayaran

Jenis parameter

string

Definisi

Kode jaringan pembayaran

Jenis parameter

stringuuid

Nilai default

string uuid acak

Definisi

uuid dompet bisnis

Jenis parameter

stringmin:1max:32alpha_dash

Nilai default

string acak

Definisi

ID pesanan faktur

Jenis parameter

string

Nilai default

paid

Definisi

Status pembayaranPilihan yang tersedia:- process- check- paid- paid_over- fail- wrong_amount- cancel- system_fail- refund_process- refund_fail- refund_paid

* - parameter wajib

Contoh permintaan


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

Tanggapan

Contoh respons


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

Kemungkinan kesalahan

Kesalahan validasi

kode : 422

contoh tanggapan:

Jika Anda meneruskan uuid atau order_id dan faktur/dompet statis/pembayaran tidak ditemukan:


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


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


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

Jika Anda tidak melewati parameter yang diperlukan:


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

Jika mata uang dan jaringan yang disediakan bukan kripto atau tidak didukung:


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


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