Documentação da API

Tudo que você precisa para integrar pagamentos e-Mola e M-Pesa em suas aplicações.

Início Rápido

Comece a usar nossas APIs em poucos minutos

1

Crie sua conta

Registre sua empresa e obtenha sua API key

2

Configure a API

Use sua API key no header x-api-key

3

Envie pagamentos

Faça requisições POST para nossas APIs

Autenticação

Como autenticar suas requisições

Todas as requisições devem incluir sua API key no header x-api-key.


  -H "Content-Type: application/json" \
  -H "x-api-key: pk_your_api_key_here" \
  -d '{
    "numero_destino": "258841234567",
    "valor": 100,
    "descricao": "Pagamento de teste"
  }'

Endpoints da API

Endpoints disponíveis para pagamentos

POST
https://paymoz.tech/api/c2b/mpesa/send

Registra venda via M-Pesa (cliente paga à loja)

Parâmetros (JSON):

{
  "numero_destino": "258841234567",
  "valor": 100,
  "descricao": "Venda M-Pesa"
}

Resposta:

{
  "success": true,
  "message": "Pagamento processado com sucesso",
  "transaction_id": "mpesa_...",
  "status": "sucesso",
  "valor": 100,
  "numero_destino": "258841234567"
}

Códigos de Erro

Possíveis erros e suas soluções

401
API Key inválida

Verifique se sua API key está correta no header x-api-key

400
Dados inválidos

Verifique os parâmetros enviados no corpo da requisição

403
Saldo insuficiente

Sua conta não possui saldo suficiente para esta transação

500
Erro interno

Erro interno do servidor. Tente novamente ou entre em contato

Exemplos de Código

Exemplos práticos em diferentes linguagens

curl -X POST https://paymoz.tech/api/mpesa/send \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_your_api_key_here" \
  -d '{
    "numero_destino": "258841234567",
    "valor": 100,
    "descricao": "Pagamento de teste"
  }'

Status das Transações

Possíveis status de uma transação

pendente

Transação criada e aguardando processamento

sucesso

Transação processada com sucesso

erro

Erro no processamento da transação

cancelado

Transação cancelada pelo usuário ou sistema