استرداد المدفوعات على العنوان المحظور

post
https://api.cryptomus.com/v1/wallet/blocked-address-refund
ينسخ

يمكنك استرداد الأموال مرة واحدة فقط.

طلب

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

اسمنوع المعلمةتعريف
uuidstringuuidrequired_without: order_iduuid من محفظة ثابتة
order_idstringmin:1max:32alpha_dashrequired_without: uuidمعرف الطلب من محفظة ثابتة
address*stringmin:10max:128alpha_dashاسترداد جميع الأموال المحظورة لهذا العنوان

نوع المعلمة

stringuuidrequired_without: order_id

تعريف

uuid من محفظة ثابتة

نوع المعلمة

stringmin:1max:32alpha_dashrequired_without: uuid

تعريف

معرف الطلب من محفظة ثابتة

نوع المعلمة

stringmin:10max:128alpha_dash

تعريف

استرداد جميع الأموال المحظورة لهذا العنوان

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

لاسترداد المدفوعات ، تحتاج إلى تمرير إما uuid أو order_id ، إذا قمت بتمرير كليهما ، فسيتم تحديد المحفظة الثابتة بواسطة uuid

طلب مثال


curl https://api.cryptomus.com/v1/wallet/blocked-address-refund \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
    "order_id": "1",
      "address": "TK8..."
}'
ينسخ

إجابة

معلمات الاستجابة

اسمتعريف
commissionلجنة الاسترداد
amountمقدار الاسترداد

تعريف

لجنة الاسترداد

تعريف

مقدار الاسترداد

مثال على الاستجابة


1{
2    "state": 0,
3    "result": {
4        "commission": "0.50",
5        "amount": "9.50"
6    }
7}
ينسخ

الأخطاء المحتملة

أخطاء التحقق من الصحة

شفرة : 422

الإجابات مثال:

إذا لم تقم بتمرير uuid و order_id ، فستتلقى هذه الرسالة. وهذا يعني أن أحد المعلمات على الأقل مطلوب.


1{
2	"state": 1,
3	"errors": {
4		"uuid": ["validation.required_without"],
5		"order_id": ["validation.required_without"]
6	}
7}
ينسخ

إذا لم يتم العثور على محفظة ثابتة:


1{
2    "state": 1,
3    "message": "Not found"
4}
ينسخ

طالما أن السحب مسموح به مرة واحدة فقط من محفظة ثابتة محظورة ، إذا تم الانسحاب بالفعل ، فسوف تتلقى رسالة الخطأ هذه:


1{
2    "state": 1,
3    "message": "You can withdraw only once"
4}
ينسخ

طالما أن السحب مسموح به مرة واحدة فقط من محفظة ثابتة محظورة ، إذا قمت بحظر محفظة ثابتة مع معلمة is_force_refund = true ، فقد تم بالفعل الانسحاب وسوف تتلقى رسالة الخطأ هذه:


1{
2    "state": 1,
3    "message": "You can withdraw only once"
4}
ينسخ

إذا كان الاسترداد قيد التشغيل بالفعل:


1{
2    "state": 1,
3    "message": "Refund is in process"
4}
ينسخ

إذا تم حظر الدفع على التاجر أو المستخدم ، فستتلقى رسالة الخطأ هذه. يحدث هذا ، على سبيل المثال ، عند تغيير كلمة المرور الخاصة بك ويتم حظر المدفوعات لمدة 24 ساعة.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
ينسخ

إذا لم يتم دفع أي مدفوعات للمحفظة الثابتة:


1{
2    "state": 1,
3    "message": "Nothing to withdraw"
4}
ينسخ

إذا كان مبلغ الدفع أقل من الحد الأدنى للمبلغ المدعوم للعملة المشفرة ، فستتلقى رسالة الخطأ هذه:


1{
2    "state": 1,
3    "message": "The amount is too small"
4}
ينسخ

في حالة حدوث عمل فني أو أن الدفع غير متوفر مؤقتًا ، ستتلقى رسائل الخطأ هذه:


1{
2    "state": 1,
3    "message": "Server error"
4}
ينسخ


1{
2    "state": 1,
3    "message": "The service was not found"
4}
ينسخ

خطأ في الخادم الداخلي

شفرة : 500

الإجابات مثال:


1{
2	"message": "Server error, #1",
3	"code": 500,
4	"error": null
5}
ينسخ