REST API v1
API de recarga móvel: Envio automático para celulares pré-pagos em 161 países
Conecte-se diretamente a 552 operadores e 4,330 produtos do seu servidor, aplicativo ou plataforma de e-commerce. Mesmos preços do MobileTopup, com média de 35% abaixo do valor nominal, comece instantaneamente com uma chave.
- URL base
- /api/v1
- Formato
- JSON
- Autenticação
- X-Api-Key
- Limites de taxa
- 300 por minuto por chave
A API de recarga mais acessível para empresas
Mesmos preços mais baixos mostrados
Os preços da API correspondem exatamente. Todos os produtos custam 30%+ abaixo do valor nominal, sem taxas de envio. Exemplo: Filipinas Globe 50 PHP (valor $0.78), preço API $0.54 (30% abaixo do valor nominal).
Comece instantaneamente sem aprovação
Cadastre-se e crie sua chave API diretamente no painel após seu primeiro crédito adicionado. Sem contratos ou pedidos mínimos.
Cobertura global de uma vez
Envie créditos e pacotes de dados para 161 países e 552 operadoras em todo o mundo com o mesmo processo simples.
Sem preocupações com pagamentos duplicados
Anexe seu número de pedido ao campo de referência, mesmo que a mesma solicitação chegue duas vezes, processaremos apenas uma vez e retornaremos o resultado original.
Crédito reembolsado instantaneamente se falhar
Se a operadora rejeitar o crédito, o valor do pagamento é reembolsado imediatamente como crédito com códigos de erro claros.
Registros completos com recibos
Créditos enviados por API aparecem no histórico do seu painel com recibos, códigos de recarga e números de referência da operadora.
Endpoints
O processo: Selecione país, operadora e produto, envie o crédito, depois verifique o status e recibos usando o código de recarga recebido.
Começando
- Passo 1
Cadastre-se
Registre-se com apenas um token de conta. Nenhum e-mail ou documento necessário.
- Passo 2
Adicionar crédito
Adicione crédito via 12 métodos incluindo USDT, USDC, BTC e ETH. Primeiras recargas ganham crédito bônus baseado no valor.
- Passo 3
Criar chave API
Gere chaves API no seu painel. Chaves completas são mostradas apenas uma vez, salve-as diretamente nas variáveis de ambiente do seu servidor.
- Passo 4
Enviar recarga
Envie chaves via cabeçalho X-Api-Key e POST /v1/recharges para enviar créditos.
Enviar crédito (cURL)
curl -X POST https://mobiletopup.io/api/v1/recharges \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"phone":"+639171234567","operator_id":"PH-GB","product_id":"ph-gb-a15c6dd","reference":"order-1042"}'Resposta (201)
{ "ok": true, "data": {
"code": "RC-7KQ2-M9XD-4PWA", "status": "completed",
"phone": "+639171234567", "operator_id": "PH-GB",
"receive": "50 PHP", "price": "0.54", "currency": "USD",
"reference": "order-1042", "duplicate": false
} }FAQ da API de Recarga Móvel
Quem pode usar a API?
Qualquer membro do MobileTopup. O cadastro leva 1 minuto com apenas um token de conta. Após o processamento da sua primeira adição de crédito, você pode gerar chaves de API imediatamente no seu painel, sem necessidade de aplicação ou aprovação.
Os preços da API são os mesmos mostrados?
Sim, idênticos. Mesmos produtos, mesmos preços, mesmas regras de envio de recargas do seu painel. Todos os produtos custam 30%+ abaixo do valor nominal (média de 35% de economia), sem taxas extras ao enviar. Os pagamentos são deduzidos diretamente do seu crédito.
Como são evitados pedidos duplicados?
Inclua o ID do pedido como referência ao enviar recargas. Se problemas de rede causarem solicitações duplicadas, processaremos apenas a primeira e retornaremos seu resultado para tentativas subsequentes ("duplicate": true).
Existem limites de taxa?
Cada chave permite 300 solicitações por minuto. Exceder isso retorna HTTP 429 com Retry-After (segundos). Espaçe as solicitações em massa adequadamente.
O que acontece se uma recarga falhar?
Se o operador rejeitar a recarga, seu pagamento é reembolsado instantaneamente como crédito. Os códigos de erro na resposta permanecem consistentes para tratamento automatizado.
Como as chaves de API são protegidas?
As chaves são armazenadas com hash e exibidas apenas uma vez durante a geração. Regenerar chaves invalida imediatamente as anteriores. Recomendamos usar chaves apenas no lado do servidor.