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

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

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

متد ChangeUserCredit2

با استفاده از این متد می‌توانید مقدار اعتبار کاربران مستقیم و غیرمستقیم نمایندۀ اصلی را بر حسب پیامک تغییر دهید. یعنی موجودی پنل کاربران‌تان را بر حسب «تعداد پیامک» ویرایش کنید. برای مثال 100 پیامک به موجودی پنل پیامکی کاربر اضافه یا از ایشان کسر کنید.

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

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

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

نام پارامترنوع پارامترتوضیحات
ReturnValue Int 3- : مبلغ درخواستی برای کسر اعتبار از پنل کاربر، بیش از موجودی کاربر است.
2- : موجودی نماینده کافی نیست.
1- : نام کاربری درخواستی صحیح نیست یا در زیرمجموعۀ شما قرار ندارد.
0 : نام کاربری یا APIKey نماینده صحیح نیست.
1 : عملیات تغییر موجودی پنل کاربر، با موفقیت انجام شد.
ChangeUserCredit2
//بدون نیاز به پکیج گیت هاب 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'       => '',
        'amount' => '',
        'description'           => '',
        'targetUsername' => '',
        'GetTax'           => '',
    ];

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

    var_dump($response->ChangeUserCredit2Result);

} 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();
}