Api do metallisson

Documentação da API de recarga

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á:

  1. criar uma conta em nosso painel
  2. preencher todos os seus dados no perfil
  3. adicionar R$10 no mínimo à sua carteira
  4. 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.