تست webhook

پرداخت تست

post
https://api.cryptomus.com/v1/test-webhook/payment
کپی

برای اعتبارسنجی امضا از آرایه داده Webhook ، از کلید API پرداخت استفاده کنید.

برای اطمینان از دریافت صحیح webhooks و امکان تأیید امضا، باید از این روش برای آزمایش webhooks برای پرداخت استفاده کنید.
لطفاً توجه داشته باشید که هیچ داده‌ای در پایگاه داده ذخیره نمی‌شود و هر داده‌ای که در webhook دریافت می‌شود تنها برای اهداف آزمایشی در یک آرایه ذخیره می‌شود تا صحت امضاء را بررسی کرده و این آرایه را از ما بازیابی آزمایش کند.

برای تست یک webhook با فاکتور موجود، لطفاً uuid یا شناسه سفارش آن را ارائه دهید. اگر این پارامترها ارائه نشوند، webhook با فاکتور آزمایشی ارسال خواهد شد.

درخواست

پارامترهای پرس و جو

نامنوع پارامتریمقدار پیش فرضتعریف
url_callback*stringmin:6max:150urlURL که webhooks با وضعیت پرداخت به آن ارسال خواهد شد
currency*stringفاکتور کد ارز
network*stringکد شبکه فاکتور
uuidstringuuidرشته UUID تصادفیUUID از فاکتور
order_idstringmin:1max:32alpha_dashرشته تصادفیشناسه فاکتور را سفارش دهید
status*stringpaidوضعیت پرداختگزینه های موجود:• process• check• paid• paid_over• fail• wrong_amount• cancel• system_fail• refund_process• refund_fail• refund_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 یا ORDER_ID را تصویب کنید ، اگر هر دو را تصویب کنید ، حساب توسط UUID مشخص می شود

مثال


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 تصادفیUUID پرداخت
order_idstringmin:1max:32alpha_dashرشته تصادفیشناسه پرداخت پرداخت
status*stringpaidوضعیت پرداختگزینه های موجود:• process• check• paid• fail• cancel• system_fail

نوع پارامتری

stringmin:6max:150url

تعریف

URL که webhooks با وضعیت پرداخت به آن ارسال خواهد شد

نوع پارامتری

string

تعریف

کد ارز پرداخت

نوع پارامتری

string

تعریف

کد شبکه پرداخت

نوع پارامتری

stringuuid

تعریف

UUID پرداخت

نوع پارامتری

stringmin:1max:32alpha_dash

تعریف

شناسه پرداخت پرداخت

نوع پارامتری

string

تعریف

وضعیت پرداختگزینه های موجود:- process- check- paid- fail- cancel- system_fail

* - پارامتر اجباری

ممکن است یکی از پارامترهای UUID یا ORDER_ID را تصویب کنید ، اگر هر دو را تصویب کنید ، حساب توسط UUID مشخص می شود

مثال


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 تصادفیکیف پول تجارت
order_idstringmin:1max:32alpha_dashرشته تصادفیشناسه فاکتور را سفارش دهید
status*stringpaidوضعیت پرداختگزینه های موجود:• process• check• paid• paid_over• fail• wrong_amount• cancel• system_fail• refund_process• refund_fail• refund_paid

نوع پارامتری

stringmin:6max:150url

تعریف

URL که webhooks با وضعیت پرداخت به آن ارسال خواهد شد

نوع پارامتری

string

تعریف

کد ارز پرداخت

نوع پارامتری

string

تعریف

کد شبکه پرداخت

نوع پارامتری

stringuuid

تعریف

کیف پول تجارت

نوع پارامتری

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}
کپی