انتقل إلى المحتوى
WATADCASH API v2

مرجع API

كل المسارات والترويسات ومخططات الطلب والاستجابة في API v2.

عنوان الأساس: https://watadcash.com/api/v2. مصدر الحقول هو ملف OpenAPI المنشور من وتد كاش والمرفق مع هذه الوثائق. الأمثلة معروضة للنسخ ولا تنفّذ طلبات.

GET/wallet

رصيد محفظة التاجر

الصلاحية: wallet:read

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        },
        "wallet": {
            "type": "object",
            "required": [
                "currency",
                "available",
                "locked",
                "withdrawable_gateway"
            ],
            "properties": {
                "currency": {
                    "const": "USD"
                },
                "available": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]*)\\.[0-9]{2}$"
                },
                "locked": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]*)\\.[0-9]{2}$"
                },
                "withdrawable_gateway": {
                    "type": "string",
                    "pattern": "^(0|[1-9][0-9]*)\\.[0-9]{2}$"
                }
            }
        }
    },
    "additionalProperties": true
}
GET/transactions

حركات المحفظة

الصلاحية: transactions:read

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/customers

العملاء

الصلاحية: customers:read

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
POST/customers

إنشاء عميل

الصلاحية: customers:write

جسم JSON

الحقلالنوعمطلوبالقيود
namestringنعم{"minLength":2,"maxLength":100}
emailstringنعم{"maxLength":190}
external_referencestringنعم{"pattern":"^[A-Za-z0-9_.:-]{1,100}$"}
مخطط الطلب الكامل
JSON Schema
{
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "name": {
            "type": "string",
            "minLength": 2,
            "maxLength": 100
        },
        "email": {
            "type": "string",
            "format": "email",
            "maxLength": 190
        },
        "external_reference": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_.:-]{1,100}$"
        }
    },
    "required": [
        "name",
        "email",
        "external_reference"
    ]
}

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/customers/{id}

تفاصيل العملاء

الصلاحية: customers:read

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
idpathنعم

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/cards

البطاقات

الصلاحية: cards:read

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
POST/cards

طلب إصدار بطاقة

الصلاحية: cards:create

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
Idempotency-Keyheaderنعم

جسم JSON

الحقلالنوعمطلوبالقيود
plan_codestringنعم{"enum":["cards_500","cards_2500","cards_unlimited"]}
customer_idintegerنعم{"minimum":1}
product_idintegerنعم{"minimum":1}
referencestringنعم{"pattern":"^[A-Za-z0-9_.:-]{1,100}$"}
مخطط الطلب الكامل
JSON Schema
{
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "plan_code": {
            "type": "string",
            "enum": [
                "cards_500",
                "cards_2500",
                "cards_unlimited"
            ]
        },
        "customer_id": {
            "type": "integer",
            "minimum": 1
        },
        "product_id": {
            "type": "integer",
            "minimum": 1
        },
        "reference": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_.:-]{1,100}$"
        }
    },
    "required": [
        "plan_code",
        "customer_id",
        "product_id",
        "reference"
    ]
}

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/cards/{id}

تفاصيل البطاقات

الصلاحية: cards:read

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
idpathنعم

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/card-orders

طلبات البطاقات

الصلاحية: cards:read

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/card-orders/{id}

تفاصيل طلبات البطاقات

الصلاحية: cards:read

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
idpathنعم

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/invoices

فواتير USDT للعملاء

الصلاحية: invoices:read

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
POST/invoices

فتح فاتورة USDT لعميل

الصلاحية: invoices:create

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
Idempotency-Keyheaderنعم

جسم JSON

الحقلالنوعمطلوبالقيود
customer_idintegerنعم{"minimum":1}
amountstringنعم{"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"}
external_referencestringلا{"pattern":"^[A-Za-z0-9_.:-]{1,100}$"}
مخطط الطلب الكامل
JSON Schema
{
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "customer_id": {
            "type": "integer",
            "minimum": 1
        },
        "amount": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$",
            "description": "Decimal string; positive value and current server limits are checked before acceptance."
        },
        "external_reference": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_.:-]{1,100}$"
        }
    },
    "required": [
        "customer_id",
        "amount"
    ]
}

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/invoices/{id}

تفاصيل فواتير USDT للعملاء

الصلاحية: invoices:read

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
idpathنعم

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/wallet-payments

طلبات الدفع من محفظة WATADCASH

الصلاحية: wallet_payments:read

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
POST/wallet-payments

طلب دفع من محفظة WATADCASH

الصلاحية: wallet_payments:create

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
Idempotency-Keyheaderنعم

جسم JSON

الحقلالنوعمطلوبالقيود
amountstringنعم{"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"}
descriptionstringنعم{"maxLength":200}
مخطط الطلب الكامل
JSON Schema
{
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "amount": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$",
            "description": "Decimal string; positive value and current server limits are checked before acceptance."
        },
        "description": {
            "type": "string",
            "maxLength": 200
        }
    },
    "required": [
        "amount",
        "description"
    ]
}

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/wallet-payments/{id}

تفاصيل طلبات الدفع من محفظة WATADCASH

الصلاحية: wallet_payments:read

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
idpathنعم

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/withdrawals

السحوبات

الصلاحية: withdrawals:read

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
POST/withdrawals

تأكيد طلب السحب

الصلاحية: withdrawals:create

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
Idempotency-Keyheaderنعم

جسم JSON

الحقلالنوعمطلوبالقيود
quote_idstringنعم{"pattern":"^[a-f0-9]{64}$"}
noncestringنعم{"pattern":"^[a-f0-9]{48}$"}
مخطط الطلب الكامل
JSON Schema
{
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "quote_id": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
        },
        "nonce": {
            "type": "string",
            "pattern": "^[a-f0-9]{48}$"
        }
    },
    "required": [
        "quote_id",
        "nonce"
    ]
}

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/withdrawals/{id}

تفاصيل السحوبات

الصلاحية: withdrawals:read

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
idpathنعم

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/transfers

التحويلات

الصلاحية: transactions:read

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
POST/transfers

تحويل إلى حساب WATADCASH

الصلاحية: transfers:create

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
Idempotency-Keyheaderنعم

جسم JSON

الحقلالنوعمطلوبالقيود
amountstringنعم{"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"}
recipientstringنعم—
مخطط الطلب الكامل
JSON Schema
{
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "amount": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$",
            "description": "Decimal string; positive value and current server limits are checked before acceptance."
        },
        "recipient": {
            "type": "string",
            "description": "Actual WATADCASH account number of the recipient."
        }
    },
    "required": [
        "amount",
        "recipient"
    ]
}

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/transfers/{id}

تفاصيل التحويلات

الصلاحية: transactions:read

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
idpathنعم

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/office-transfers

الحوالات المكتبية

الصلاحية: transactions:read

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
POST/office-transfers

حوالة إلى مكتب

الصلاحية: office:transfers:create

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
Idempotency-Keyheaderنعم

جسم JSON

الحقلالنوعمطلوبالقيود
amountstringنعم{"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"}
recipient_namestringنعم—
recipient_phonestringنعم—
officestringنعم—
receive_currencystringنعم—
مخطط الطلب الكامل
JSON Schema
{
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "amount": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$",
            "description": "Decimal string; positive value and current server limits are checked before acceptance."
        },
        "recipient_name": {
            "type": "string"
        },
        "recipient_phone": {
            "type": "string"
        },
        "office": {
            "type": "string",
            "description": "A currently available office code from the merchant account configuration."
        },
        "receive_currency": {
            "type": "string",
            "description": "Currently supported office receiving currency."
        }
    },
    "required": [
        "amount",
        "recipient_name",
        "recipient_phone",
        "office",
        "receive_currency"
    ]
}

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/office-transfers/{id}

تفاصيل الحوالات المكتبية

الصلاحية: transactions:read

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
idpathنعم

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/card-products

منتجات البطاقات المتاحة

الصلاحية: cards:read

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
GET/funding

فواتير تمويل محفظة التاجر

الصلاحية: wallet:read

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
POST/funding

فاتورة USDT لتمويل محفظة التاجر

الصلاحية: wallet:fund

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
Idempotency-Keyheaderنعم

جسم JSON

الحقلالنوعمطلوبالقيود
amountstringنعم{"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"}
مخطط الطلب الكامل
JSON Schema
{
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "amount": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$",
            "description": "Decimal string; positive value and current server limits are checked before acceptance."
        }
    },
    "required": [
        "amount"
    ]
}

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
POST/cards/{id}/fund

طلب تمويل بطاقة مملوكة

الصلاحية: cards:fund

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
idpathنعم
Idempotency-Keyheaderنعم

جسم JSON

الحقلالنوعمطلوبالقيود
plan_codestringنعم{"enum":["cards_500","cards_2500","cards_unlimited"]}
amountstringنعم{"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,2})?$"}
referencestringنعم{"pattern":"^[A-Za-z0-9_.:-]{1,100}$"}
مخطط الطلب الكامل
JSON Schema
{
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "plan_code": {
            "type": "string",
            "enum": [
                "cards_500",
                "cards_2500",
                "cards_unlimited"
            ]
        },
        "amount": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,2})?$"
        },
        "reference": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_.:-]{1,100}$"
        }
    },
    "required": [
        "plan_code",
        "amount",
        "reference"
    ]
}

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
POST/withdrawals/quote

عرض سحب USDT عبر TRON

الصلاحية: withdrawals:create

الترويسات ومعاملات المسار

الحقلالموضعمطلوب
Idempotency-Keyheaderنعم

جسم JSON

الحقلالنوعمطلوبالقيود
amountstringنعم{"pattern":"^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$"}
addressstringنعم{"pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$"}
مخطط الطلب الكامل
JSON Schema
{
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "amount": {
            "type": "string",
            "pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,6})?$",
            "description": "Decimal string; positive value and current server limits are checked before acceptance."
        },
        "address": {
            "type": "string",
            "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$"
        }
    },
    "required": [
        "amount",
        "address"
    ]
}

الاستجابة

رموز الاستجابة الموثقة: 200 · 400 · 401 · 403 · 404 · 409 · 422 · 429 · 503

مخطط استجابة 200
JSON Schema
{
    "type": "object",
    "required": [
        "ok"
    ],
    "properties": {
        "ok": {
            "const": true
        }
    },
    "additionalProperties": true
}
مرجع API الكاملتحديث الوثائق: 9 أكتوبر 2026