اختبار 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

تعريف

uuid من الفاتورة

نوع المعلمة

stringmin:1max:32alpha_dash

القيمة الافتراضية

سلسلة عشوائية

تعريف

معرف الطلب من الفاتورة

نوع المعلمة

string

القيمة الافتراضية

paid

تعريف

حالة السدادالخيارات المتاحة:- 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

تعريف

uuid من الدفع

نوع المعلمة

stringmin:1max:32alpha_dash

القيمة الافتراضية

سلسلة عشوائية

تعريف

معرف الطلب من الدفع

نوع المعلمة

string

القيمة الافتراضية

paid

تعريف

حالة الدفعالخيارات المتاحة:- 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

تعريف

uuid من محفظة الأعمال

نوع المعلمة

stringmin:1max:32alpha_dash

القيمة الافتراضية

سلسلة عشوائية

تعريف

معرف الطلب من الفاتورة

نوع المعلمة

string

القيمة الافتراضية

paid

تعريف

حالة السدادالخيارات المتاحة:- 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}
ينسخ