Gateway API

Integre o NetShop
em qualquer sistema.

Uma API REST pensada para programadores: documentação séria, SDKs oficiais e webhooks fiáveis. Para ERPs, e-commerce, apps móveis ou qualquer backend.

POST /v1/charges
curl -X POST https://www.netshop.co.mz/api/v1/charges \
  -H "Authorization: Bearer ns_live_sk_••••••••" \
  -H "X-Wallet-ID: 418207" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -H "Content-Type: application/json" \
  -d '{"amount":2500,"currency":"MZN","method":"mpesa","msisdn":"+258842828600","reference":"Fatura #2410"}'
01 — Endpoints

REST versionada

Endpoints estáveis com versionamento por URL, paginação cursor-based e erros estruturados em JSON.

02 — SDKs

Node, Python, PHP, Java

Bibliotecas oficiais mantidas pela equipa, com tipagem completa em TypeScript e cobertura de testes.

03 — Webhooks

Assinados e fiáveis

Eventos assinados com HMAC, retentativas exponenciais até 72h e replay manual em um clique.

04 — Mínimos

Limites claros, ambiente 100% LIVE

M-Pesa e mKesh 10 MT, e-Mola e Visa/Mastercard 50 MT (ZAR R 10). Payout manual 1 000 MT; payouts automáticos e B2C sem mínimo.

05 — Auth

API keys com scope

Chaves separadas por ambiente, escopo granular e rotação sem downtime.

06 — Idempotência

Idempotency-Key nativa

Todas as operações de escrita aceitam Idempotency-Key. Retentativas seguras, sem dupla cobrança.

07 — M-Pesa

C2B e B2C end-to-end

O mesmo edge M-Pesa alimenta Links de Pagamento, Split Payments, Débito Directo e Payouts (manuais e automáticos). Validação MSISDN, callback assinado por HMAC e reconciliação automática por third_party_reference.

Programador moçambicano integrando a Gateway API NetShop em Maputo
Equipas de engenharia em Maputo, Matola e Beira usam a Gateway API NetShop para ligar ERP, e-commerce e apps móveis.

Comece a integrar em minutos.

Chaves LIVE imediatas. Documentação completa em netshop.co.mz/docs. Suporte humano em português.