اختبار webhook

اختبار الدفع

post
https://api.cryptomus.com/v1/test-webhook/payment
ينسخ

للتحقق من صحة التوقيع من مجموعة بيانات WebHook ، استخدم مفتاح الدفع API.

للتأكد من أنك تتلقى Webhooks بشكل صحيح ويمكنك التحقق من صحة التوقيع ، يجب عليك استخدام هذه الطريقة لاختبار Webhooks للدفع.
يرجى ملاحظة أنه لا يتم حفظ أي بيانات في قاعدة البيانات ، ويتم تخزين أي بيانات تم استلامها في webhook فقط في صفيف لأغراض الاختبار لضمان صحة التوقيع واختبار استرجاع هذه الصفيف منا.

لاختبار webhook مع فاتورة موجودة ، يرجى تقديم معرف uuid أو الطلب. إذا لم يتم توفير هذه المعلمات ، فسيتم إرسال webhook مع فاتورة اختبار.

طلب

معلمات الاستعلام

اسمنوع المعلمةالقيمة الافتراضيةتعريف
url_callback*stringmin:6max:150urlعنوان URL الذي سيتم إرسال Webhooks مع حالة الدفع إليه
currency*stringرمز العملة الفاتورة
network*stringرمز شبكة الفاتورة
uuidstringuuidسلسلة عشوائية uuiduuid من الفاتورة
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:150urlعنوان URL الذي سيتم إرسال Webhooks مع حالة الدفع إليه
currency*stringرمز العملة الدفع
network*stringرمز شبكة الدفع
uuidstringuuidسلسلة عشوائية uuiduuid من الدفع
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:150urlعنوان URL الذي سيتم إرسال Webhooks مع حالة الدفع إليه
currency*stringرمز عملة الدفع
network*stringرمز شبكة الدفع
uuidstringuuidسلسلة عشوائية uuiduuid من محفظة الأعمال
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

* - المعلمة الإلزامية

طلب مثال


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}
ينسخ