پرش به مطلب اصلی

افزایش موجودی (Top-up)

برای شارژ حساب کاربری استفاده می‌شود.

توضیحات​

این API برای شروع فرآیند پرداخت و شارژ کیف پول کاربر استفاده می‌شود. پس از ارسال درخواست، یک redirect_url در پاسخ دریافت می‌شود که کاربر باید به آن هدایت شود. این URL کاربر را به درگاه بانک منتقل کرده و پس از تکمیل پرداخت، به پنل سازمانی باز می‌گرداند.

اطلاعات عمومی​

  • آدرس: <base_url>/api/v2/wallet/top-up
  • متد: POST
  • نوع محتوا: application/json
  • احراز هویت: نیازمند token

احراز هویت​

  • این درخواست نیاز به یک Authorization token دارد که باید در هدر ارسال شود.

هدرها​

کلیدمقدار
Authorization<token>
Content-Typeapplication/json

پارامترهای بدنه درخواست (Request Body)​

فیلدنوع دادهتوضیحات
amountintegerمبلغ پرداخت به ریال (مثلاً 10000)

نمونه Request Body:

{
    "amount": 10000
}

پاسخ موفق​

{
    "status": 200,
    "data": {
        "redirect_url": "https://api.snapp.site/finance/asan-pardakht/redirect/89115c118c602d1926eaa3c8a10195b74addefb3?from=corporate",
        "callback_url": "https://api.snapp.site/finance/asan-pardakht/callback"
    }
}