A documentação da API de recarga e cartões de presentes (gift cards) do metallisson foi construída pra ser simples.
Antes de mais nada você deverá:
- criar uma conta em nosso painel
- preencher todos os seus dados no perfil
- adicionar R$10 no mínimo à sua carteira
- criar uma chave de api no menu configuração
Segue as funções disponíveis.
Como saber meu saldo em carteira?
Faça um GET para a URL: https://www.metallisson.com/api/v1.0/recarga
Parâmetros da solicitação
- chave-api ( string de 30 caracteres )
- saldo ( apenas envie true)
Retorno JSON com sucesso
[
1,
{
“saldo”: “760.50”
}
]
Retorno JSON com erro
[
0,
“Mensagem de erro”,
“código do erro”
]
Como saber quais operadoras estão habilitadas?
Faça um GET para a URL: https://www.metallisson.com/api/v1.0/recarga
Parâmetros da solicitação
- chave-api ( string de 30 caracteres )
- listar-operadoras ( apenas envie true)
Retorno JSON com sucesso
[
1,
{
“online”: [
“OI”,
“VIVO”,
“CLARO”,
“NEXTEL”,
“ALGAR”,
“TIM”,
“CORREIOS CELULAR”
],
“pin”: [
“STEAM”,
“XBOX”,
“PAYMENTEZ”,
“LEVEL UP”,
“SKY”,
“PAYSAFECARD”,
“NETFLIX”,
“UBER”
]
}
]
Retorno JSON com erro
[
0,
“Mensagem de erro”,
“código do erro”
]
Como saber quais os valores de recarga de uma operadora?
Faça um GET para a URL: https://www.metallisson.com/api/v1.0/recarga
Parâmetros da solicitação
- chave-api ( string de 30 caracteres )
- listar-faces-operadora ( enviar uma string com o nome da operadora )
Retorno JSON com sucesso
[
1,
{
“faces”: [
“10”,
“20”,
“30”,
“39.9”,
…
]
}
]
Retorno JSON com erro
[
0,
“Mensagem de erro”,
“código do erro”
]
Como fazer uma recarga online via api?
Faça um POST para a URL: https://www.metallisson.com/api/v1.0/recarga
Parâmetros da solicitação
- chave-api ( string de 30 caracteres )
- modo ( o modo é um char de 1 carácter e ele pode ser p de produção ou t de teste )
- operacao ( a operação é um char de 1 carácter sendo o para recarga online ou p para recarga pin )
- numero ( número é uma string de 11 dígitos, sendo o telefone com DDD
- operadora ( é o nome da operadora conforme comando GET ‘listar-operadoras’ )
- recarga ( é o valor da recarga conforme comando GET ‘listar-face-operadora’ )
Retorno JSON com sucesso
[
1,
{
“mensagem”: “Mensagem de sucesso”,
“nsu”: “123”,
“pin”: “123”,
“lote”: “123”,
“serie”: “123”,
“id_recarga”: “123”
}
]
Retorno JSON com erro
[
0,
“Mensagem de erro”,
“código do erro”
]
Quais os códigos de mensagem de erro, aviso e sucesso?
Código 0 de erro:
METE1 = O campo operadora está vazio!
METE2 = O campo número está vazio!
METE3 = O campo face está vazio!
METE4 = No momento não trabalhamos com essa operadora!
METE5 = O número está inválido!
METE6 = No momento não trabalhamos com essa Operadora PIN!
METE7 = No momento não trabalhamos com esse valor de face para a operadora $NOME_OPERADORA
METE8 = Você não tem crétido suficiente para realizar essa recarga. Por favor adicione mais dinheiro à sua carteira. (Saldo:$SALDO Face:$VALOR_DE_FACE )
METE9 = A data escolhida é inválida!
METE10 = Para escolher um agendamento você tem que selecionar uma data!
METE11 = O dia para repetir a recarga programada está inválido!
METE12 = Alguma coisa ocorreu de errado! Tente em outro momento.
METE13 = Ocorreu um problema ao tentar solicitar a recarga.
METE14 = A recarga no momento não pode ser solicitada!
METE15 = Produto e/ou operadora não estão presentes na classe de recarga adequada!
METE16 = Tivemos um problema no acesso à base de dados. Por favor tentar mais tarde.
Código -2 de aviso:
META1 = Essa recarga já foi programada. Caso ela esteja inativa você terá que reativa-la para que a recarga seja colocada no dia programado.
META2 = Recarga solicitada mas não confirmada.
META3 = Recarga solicitada mas não foi enviado código de confirmação.
Código 1 de sucesso
OK – Recarga efetuada com sucesso!
OK – Agendamento de recarga feito com sucesso.
Fazendo um exemplo de uma recarga Vivo em PHP
$url = ‘https://www.metallisson.com/api/v1.0/recarga’; //vamos fazer um POST para essa url
$chave = ‘sua-chave-de-api-aqui’; //pegue sua chave api no menu Configuração de sua Conta de revendedor
/*
Se você for fazer uma recarga de uma operadora de telefonia como a VIVO ou a TIM use um o na operação.
Recarga Online são recargas que são transferidas direto das operadoras.
Para recargas (Gift Cards), ou seja, que precisam de códigos de cartões (PINs) use a operação p.
Observe que o retorno JSON só retornará algum valor nos campos pin, lote e serie quando a operação for p.
*/
$operacao = ‘o’;
$numero = 83999999999; //telefone
$operadora = ‘VIVO’;//nome exato da operadora habilitada
$recarga = 10;//valor de face da recarga
$content = http_build_query(
array(
‘chave-api’ => $chave,
‘modo’ => ‘p’,//p=produção e t = teste
‘operacao’ => $operacao,//operação o = recarga online p == recarga pin
‘numero’ => $numero,//número com ddd e 11 dígitos
‘operadora’ => $operadora,
‘recarga’ => $recarga,//valor de face da recarga ex:10 é uma recarga de R$10,00 e 9.9 é uma de R$9,90
)
);
$context = stream_context_create(
array(
‘http’ => array(
‘method’ => ‘POST’,
‘content’ => $content,
‘header’ => “Content-Type: application/x-www-form-urlencoded”,
)
));
$resultado = file_get_contents($url, null, $context);
$resultado = json_decode($resultado);
//se a recarga foi efetuada com sucesso me retorne os dados
if($resultado[0]==1){
$retorno = $resultado[1];
echo $retorno[‘mensagem’];
echo $retorno[‘nsu’];
echo $retorno[‘pin’];
echo $retorno[‘lote’];
echo $retorno[‘serie’];
echo $retorno[‘id_recarga’];
}
Observe que uma recarga nunca poderá ser cancelada. Fique atento!
Para você usar a API será necessário fazer um novo cadastro de revendedor e adicionar dinheiro em sua carteira.
Qualquer dúvida entre em contato.