Primeiros passos para integração

Para inciar sua integração você deverá escolher qual vai ser a forma como seu aplicativo irá se conectar com o webservice quanto ao tipo de token.

A forma mais rápida e simples de consumir todos os recursos da api é criando um token de acesso persistente.

Fazendo isso você não se preocupará com a gestão de tokens expirados.

Caso escolha tokens de expiração em 24h, será necessário que você implemente uma rotina de geração, verificação e exclusão de tokens.

Base de dados

O nosso webservice disponibiliza centenas de recargas.

Para facilitar sua gestão sobre essa quantidade de produtos, você deve criar uma rotina de armazenamento do catálogo.

Com esses dados você poderá exibir o produto certo para um determinado DDD, por exemplo. Ou até mesmo, poderá apenas listar Gift Cards de assinatura para seus clientes.

Diariamente você deve atualizar sua lista de produtos lendo nosso catálogo. Isso evitará que você mostre produtos desatualizados para seus clientes.

O que realmente acontece é que são raras as vezes que um determinado fornecedor remove de seu catálogo ou acrescenta um novo produto, mas isso não será motivo para você por exemplo fazer uma leitura do nosso catálogo apenas 1 vez na semana.

Por outro lado procuramos adicionar novos produtos ao catálogo assim que possível, conforme nossa integração.

Manter sua base atualizada evitará qualquer tipo de desconforto para quem realmente irá usar de todos esses benefícios, o seu cliente.

Faça no mínimo uma leitura diária ao catálogo e mantenha-se atualizado com todas as nossas novidades.

Produtos excluídos ou desativados

Um produto pode ser excluído ou desativado por diversos motivos.

Nosso sistema, por exemplo, desativará qualquer produto que identificar em tempo de execução ou não, qualquer falha que possa prejudicar o cliente final.

Então, um dos erros que você não deve deixar de monitorar em seu aplicativo é o return=11. Se um produto que você tenha em sua base gerar esse erro em uma solicitação de recarga, é hora de desativa-lo.

A critério do fornecedor ou por nossa própria gestão de produtos, qualquer produto poderá ser inserido ou removido do catálogo.

Nós vendemos um saldo e você o usa com qualquer produto que tiver disponível em tempo de execução.

Como você deve disponibilizar os produtos em seu aplicativo

Quando você fizer uma leitura do catálogo observará que alguns produtos possuem restrição de uso por DDD.

Então, para evitar de mostrar um valor de recarga para um DDD que não tenha, primeiramente pergunte ao seu cliente qual o DDD dele.

Depois de saber o DDD você poderá mostrar os produtos disponíveis apenas para o DDD em questão.

Caso um produto não tenha um DDD especificado, ele estará apto a ser exibido para qualquer área nacional.

Comprovante de recarga

O comprovante de recarga faz parte da entrega do produto para seu cliente. Em seu aplicativo, a falta desse componente irá gerar uma experiência de compra desagradável para seu cliente.

Para que isso não ocorra, não deixe de exibir em seu comprovante:

  • A data e hora da compra
  • O número do seu pedido
  • O nome do fornecedor do produto
  • O valor do produto
  • O número do telefone ou identificador (cpf ou código de assinante)
  • O NSU (para recargas online)
  • O PIN (para gift cards)
  • O serial (para gift cards)
  • Alguma informação que achar importante para seu cliente

Esses itens se tornam obrigatórios para que seu aplicativo apresente uma boa experiencia de compra dos nossos produtos digitais.

Gerencie seu saldo da carteira virtual

Você concordará que ao usar uma api você quer automatizar seu processo de compra e entrega dos produtos que disponibilizamos.

Como isso é um processo que naturalmente, em tempo de execução, não envolve ação humana (seu webservice interagindo com o nosso), não deixe seu saldo ficar abaixo do que você precisa para 1 dia.

Imagine que tudo está correto com o seu processo de integração, não há nenhum erro, mas alguém esqueceu de adicionar saldo à carteira no período da tarde, ou em uma sexta-feira e quando você menos espera o saldo acaba no meio de uma demanda de compra.

Essa realmente não é uma boa coisa para seu negócio.

Procure observar nosso painel ou implemente o recurso de leitura de saldo em seu painel de gestão.

Se seu saldo ficar em cerca de no mínimo o valor que você compra em média por dia, não deixe de recarregar sua carteira. Isso evitará transtornos com seu cliente ou e uma espera desnecessária pela hora da quitação do seu pagamento.

Lembre-se que a maioria dos nossos meios de pagamentos requerem até 1 dia útil para quitação e adição de crédito.

Esteja ciente que recargas podem não ser autorizadas pelas operadoras

Já temos uma artigo falando sobre recargas com erros aqui em nossa central de ajuda.

Mas não custa informar que isso poderá ou contenteza ocorrerá com seu aplicativo. Não há motivos para qualquer pânico.

Se o volume de erros de uma determinada operadora, para diferentes números, for alto o suficiente durante um dia, para que você desconfie de algum problema, não deixe de nos comunicar.