ملی پیامک مستندات وب‌سرویس پیامک
ملی پیامک مستندات وب‌سرویس پیامک
ملی پیامک مستندات وب‌سرویس پیامک

تغییر اعتبار کاربر بر حسب ریال (متد سوم)

آخرین به روز رسانی: 9 دی 1404

متد ChangeUserCredit3

برخلاف متدهای اول و دوم، با استفاده از این متد می‌توانید مقدار اعتبار کاربران مستقیم و غیرمستقیم نمایندۀ اصلی را بر حسب ریال و تعرفۀ پایه ثابت تغییر دهید. برای مثال 2,500,000 ریال به موجودی پنل پیامکی کاربر اضافه یا از ایشان کسر کنید.

پارامتر های ورودی

نام پارامترنوع پارامترتوضیحات
username String نام کاربری مربوط به حساب شما در سامانه
password String APIKey مربوط به حساب شما در سامانه
rialAmount String مقدار ریالی که قرار است به اعتبار کاربر اضافه یا از اعتبار کاربر کسر کنید.
description String توضیحات (در تراکنش مالی پنل کاربر لحاظ خواهد شد)
targetUsername String نام کاربریِ کاربر مورد نظر جهت تخصیص اعتبار
getTax Bool لحاظ کردن مالیات بر ارزش افزوده (اگر Trueباشد مالیاتی که در قسمت تنظیمات پنل مدیریتی تعیین‌شده، لحاظ می‌شود)
getBudget Bool لحاظ کردن مقدار ریالی قانون بودجه (تبصرۀ مصوب‌شده توسط مجلس شورای اسلامی)

مقدار بازگشتی

نام پارامترنوع پارامترتوضیحات
ReturnValue Int 5- : موجودی نماینده جهت تخصیص به کاربر کافی نیست.
4- : موجودی کاربر جهت کسر اعتبار از ایشان، کافی نیست.
3- : تعرفۀ پایۀ کاربر در پنل مدیریتی یافت نشد.
2- : نام کاربریِ کاربر مورد نظر صحیح نیست یا در زیرمجموعۀ شما قرار ندارد.
1- : تعداد کاراکترِ توضیحات بیش از حد مجاز است. (حدأکثر کاراکتر مجاز توضیحات: 100 عدد است)
0 : نام کاربری یا APIKey نماینده صحیح نیست.
1 : عملیات ویرایش اعتبار ریالی، با موفقیت انجام شد.

URL ارسال پیامک با استفاده از متد ChangeUserCredit3:

https://api.payamak-panel.com/post/Users.asmx/ChangeUserCredit3?username=&password=&rialAmount=&description=&targetUsername=&getTax=&getBudget=

ChangeUserCredit3
//بدون نیاز به پکیج گیت هاب Procedural PHP نمونه کدهای 
ini_set('soap.wsdl_cache_enabled', '0');

try {
    $client = new SoapClient(
        'https://api.payamak-panel.com/post/Users.asmx?wsdl',
        [
            'encoding' => 'UTF-8',
        ]
    );

    $params = [
        'username'       => '',
        'password'       => '',
        'rialAmount' => '',
        'description'           => '',
        'targetUsername' => '',
        'getTax'           => '',
        'getBudget'           => '',
    ];

    $response = $client->ChangeUserCredit3($params);

    var_dump($response->ChangeUserCredit3Result);

} catch (SoapFault $fault) {
    echo 'SOAP Error:' . PHP_EOL;
    echo 'Code: ' . $fault->faultcode . PHP_EOL;
    echo 'Message: ' . $fault->faultstring . PHP_EOL;
} catch (Throwable $e) {
    echo 'General Error: ' . $e->getMessage();
}