buibr/budget-sms-php

Budget SMS API request with PHP.

v1.0 2021-02-16 10:05 UTC

Requires

• php: >=7.0.0
• ext-curl: *

Requires (Dev)

• phpunit/phpunit: ^7.5
• vimeo/psalm: ^4.6

BSD-4-Clause

• buibr

• sms
• budget
• budget sms
• budget sms php
• php budget sms

README

Install with composer

composer require buibr/budget-sms-php

Usage:

Example 1:

$budget = new \buibr\Budget\BudgetSMS( [
    'username'=>'xxx',
    'userid'=> 'xxx',
    'handle'=>'xxx',
]);

//  sender name
$budget->setSender("Test");

//  add recepient
$budget->setRecipient('+38971xxxxxx');

//  add message
$budget->setMessage('Testing the provider');

//  Send the message 
$send = $budget->send();

Example 2:

use buibr\Budget\BudgetSMS;

$budget = new BudgetSMS( [
    'username'=>'xxx',
    'userid'=> 'xxx',
    'handle'=>'xxx',
    'from'=>'Test',
    'price'=> 1, // optional
    'mccmnc'=> 1, // optional
    'credit'=> 1, // optional
]);

$send = $budget->send( '+38971xxxxxx', 'message content' );

Response examples:

Success:

buibr\Budget\BudgetResponse Object
(
    [code] => 200
    [type] => text/plain; charset=UTF-8
    [time] => 0.494388
    [status] => 1
    [response] => Array
        (
            [transaction] => 76208843
            [price] => 0.02
            [time] => 1
            [mccmnc] => 29401
            [credit] => 590.5892
        )

    [data] => OK 76208843 0.02 1 29401 590.5892
)

Error:

buibr\Budget\BudgetResponse Object
(
    [code] => 200
    [type] => text/plain; charset=UTF-8
    [time] => 0.32309
    [status] => 
    [response] => SMS message text is empty
    [data] => ERR 2001
)

Push DLR Handler (webhook to accept requests):

Request:

$budget = new BudgetSMS;
$dlr = $budget->pushDlr( $payload );

Response:

Array
(
    [code] => 
    [type] => 
    [time] => 
    [status] => 
    [smsid] => xxx
    [sms_code] => 7
    [sms_message] => SMSC error, message could not be processed
)

Pull DLR Handler:

Request

$budget = new BudgetSMS( [
    'username'=>'xxx',
    'userid'=> 'xxx',
    'handle'=>'xxx',
]);
$dlr = $budget->pullDLR('xxxx');

Response

Array
(
    [code] => 200
    [type] => text/html; charset=UTF-8
    [time] => 0.261374
    [status] => 
    [smsid] => xxx
    [sms_code] => 8
    [sms_message] => Message not allowed
    [data] => OK 8
)