Olá desenvolvedor gostaria de implementar junto com você um pequeno aplicativo de recarga de celular em PHP onde você facilmente poderá adapta-lo ao sistema do seu negócio.

Vamos usar a API de recarga de celular da nossa plataforma e em poucas minutos eu garanto para você que você sairá recarregando qualquer celular das operadoras disponíveis na API.

O processo de recarga de celular nada mais é do que a disponibilização de um estoque de crédito virtual com alguma operadora de telefonia.

Uma vez disponibilizado, esse estoque pode ser utilizado para que o cliente da operadora use qualquer serviço da mesma.

Nesse ponto implementaremos o processo básico de creditação de recarga em CHIPs pré-pagos de telefonia.

Entendendo o processo de creditação

A forma mais segura para fazer uma recarga é seguir o seguinte script de recarga:

  1. Pergunte o DDD do CHIP do usuário
  2. Pergunte qual a operadora do CHIP
  3. Pergunte qual o valor de recarga
  4. Confirme os dados de recarga
  5. Efetue a transação

Seguindo essas etapas a recarga de celular será solicitada com mínimas possibilidades de erros.

A API de recarga de celular da metallisson está pronta para receber as solicitações baseadas nesses passos básicos.

Funções básicas para uso da API

Seguindo a orientação da página de documentação toda chamada para o endpoint sempre transporta o atributo “chave-api“.

Nesse ponto construí dois exemplos bem simples que implementará de duas maneiras a chamada para a URL do webservice.

Executando as ações POST em PHP

Para o envio de solicitações em POST implementei um script em curl.

Você poderá usa-las em qualquer solicitação.

function geraPOST_METALLISSON($campos = array()) {
    
            $url = 'https://www.metallisson.com/api/v1.1/recarga';
            
            $chave = 'sua-chave-aqui';            
            
            $campos = array_merge($campos, array(
                'chave-api' => $chave
            ));

            $requisicao = curl_init ($url);

            curl_setopt($requisicao , CURLOPT_RETURNTRANSFER, true);            
            curl_setopt($requisicao , CURLOPT_POST, true);
            curl_setopt($requisicao , CURLOPT_POSTFIELDS, $campos);

            $resultado = curl_exec($requisicao);

            curl_close($requisicao);
            
            $json = json_decode($resultado, TRUE);
            return $json;            
            
}

Executando as ações GET em PHP

Para a leitura de informações em GET implementei um script usando.

Você poderá usa-las em qualquer solicitação.

function geraGET_METALLISSON($campos = array()) {

    $url = 'https://www.metallisson.com/api/v1.1/recarga';

    $chave = 'sua-chave-aqui';

    $campos = array_merge($campos, array(
        'chave-api' => $chave
    ));

    $content = http_build_query($campos);

    $resultado = file_get_contents($url . '?' . $content);

    $json = json_decode($resultado, TRUE);
    return $json;
}

Executando as chamadas à API

Listando todas as operadoras disponíveis

Para saber quais as operadoras estão disponíveis realize a chamada abaixo:

//pegando a relação de operadoras disponíveis
$operadoras = geraGET_METALLISSON(array('listar-operadoras'=>true));

//perguntando se tudo ocorreu bem com a solicitação
if($operadoras[0]==1){
    
    //criando uma variárel para montar um menu select
    $opcoes = '';
    
    //lendo o array de retorno e montando o menu de operadoras online
    foreach ($operadoras[1]['online'] as $operadora) {
        $opcoes .= '<option value="'.$operadora.'">'.$operadora.'</option>';
    }
    
    //imprimindo o menu de operadoras
    echo '<select name="operadora">'.$opcoes.'</select>';
}

Listando todos os produtos de uma operadora

Para saber quais os produtos disponíveis de uma determinada operadora realize a chamada abaixo:

//armazene o número do ddd do chip que receberá a recarga
$ddd_do_usuario = 83;

//pegando a relação de produtos da operadora
$produtos = geraGET_METALLISSON(
    array(
        'listar-face-operadoras'=>'NOME-OPERADORA-AQUI',
        'ddd' => $ddd_do_usuario
    )
);

//perguntando se tudo ocorreu bem com a solicitação
if($produtos[0]==1){
    
    //criando uma variárel para montar um menu select
    $opcoes = '';
    
    //lendo o array de retorno e montando o menu de produtos disponíveis
    foreach ($produtos[1] as $produto) {
        $opcoes .= '<option value="'.$produto['face'].'">'.$produto['nome'].'</option>';
    }
    
    //imprimindo o menu de produto (recarga)
    echo '<select name="recarga">'.$opcoes.'</select>';
}

Fazendo a recarga de celular em PHP

Depois de ter perguntado as informações principais da operação de recarga, execute o script de recarga.

Os dados contidos nele são os dados que deve ser recebido do usuário através da escolha do leque de produtos apresentados ao mesmo.

Execute o script abaixo:

//armazene o número do ddd do chip que receberá a recarga
$ddd_do_usuario = 83;//exemplo de ddd
$numero_do_usuario = 999999999;//exemplo de número
$telefone_do_usuario = $ddd_do_usuario.''.$numero_do_usuario;//telefone completo

$operadora = 'NOME-OPERADORA';//nome da operadora em maiúsculo
$valor_de_recarga = 10;//exemplo de recarga de R$10,00
$operacao = 'o';//sinaliza a utilização do módulo de recarga online


//solicitando uma recarga
$solicitacao = geraPOST_METALLISSON(
    array(
        'operacao' => $operacao,
        'numero'   => $telefone_do_usuario,
        'operadora'=> $operadora,
        'recarga'  => $recarga
    )
);

//perguntando se tudo ocorreu bem com a solicitação
if($solicitacao[0]==1){
    
    //testando se houve retorno da operadora
    if(isset($solicitacao['nsu']) && $solicitacao['nsu']!=''){
        
        echo 'Recarga realizada!';
        
    }
}

 


Deixe um comentário

Deus seja louvado!