Pagamentos 💳

Sistema de pagamentos integrado - MercadoPago, M-Pesa, E-Mola

Pagamento via MercadoPago

POST/api/payment/mercadopago

Cria um pagamento via MercadoPago para usuários no Brasil e América Latina.

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
email	string	Sim	Email do pagador
amount	number	Sim	Valor do pagamento
description	string	Sim	Descrição do pagamento
usuario_id	string	Sim	ID do usuário na plataforma

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/payment/mercadopago \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "usuario@email.com",
    "amount": 29.90,
    "description": "Plano PRO - Alauda API",
    "usuario_id": "user_123"
  }'

Resposta

json

{
  "success": true,
  "message": "Pagamento criado com sucesso",
  "data": {
    "payment_id": "mp_1234567890",
    "status": "pending",
    "payment_url": "https://www.mercadopago.com.br/checkout/v1/redirect?pref_id=...",
    "amount": 29.90,
    "currency": "BRL",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Pagamento via M-Pesa

POST/api/payment/mpesa

Cria um pagamento via M-Pesa (Vodacom Moçambique).

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
valor	number	Sim	Valor do pagamento (MZN)
numero_celular	string	Sim	Número Vodacom (formato: 84xxxxxxx)
usuario_id	string	Sim	ID do usuário na plataforma

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/payment/mpesa \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "valor": 500,
    "numero_celular": "841234567",
    "usuario_id": "user_123"
  }'

JavaScript (fetch)

javascript

const response = await fetch('https://api.alauda.mz/api/payment/mpesa', {
  method: 'POST',
  headers: {
    'X-API-Key': 'sua_api_key_aqui',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    valor: 500,
    numero_celular: '841234567',
    usuario_id: 'user_123'
  })
});

const data = await response.json();
console.log(data.data.transaction_id);

Resposta

json

{
  "success": true,
  "message": "Pagamento M-Pesa iniciado",
  "data": {
    "transaction_id": "mpesa_abc123",
    "status": "pending",
    "valor": 500,
    "numero_celular": "841234567",
    "currency": "MZN",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Pagamento via E-Mola

POST/api/payment/emola

Cria um pagamento via E-Mola (Movitel Moçambique).

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
valor	number	Sim	Valor do pagamento (MZN)
numero_celular	string	Sim	Número Movitel (formato: 86xxxxxxx ou 87xxxxxxx)
usuario_id	string	Sim	ID do usuário na plataforma

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/payment/emola \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "valor": 500,
    "numero_celular": "861234567",
    "usuario_id": "user_123"
  }'

Resposta

json

{
  "success": true,
  "message": "Pagamento E-Mola iniciado",
  "data": {
    "transaction_id": "emola_xyz789",
    "status": "pending",
    "valor": 500,
    "numero_celular": "861234567",
    "currency": "MZN",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Status do Pagamento

GET/api/payment/mercadopago/status/:payment_id

Consulta o status de um pagamento MercadoPago.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
payment_id	string	Sim	ID do pagamento (parâmetro na URL)

Exemplo de Requisição

bash

curl -X GET "https://api.alauda.mz/api/payment/mercadopago/status/mp_1234567890" \
  -H "X-API-Key: sua_api_key_aqui"

Resposta

json

{
  "success": true,
  "data": {
    "payment_id": "mp_1234567890",
    "status": "approved",
    "amount": 29.90,
    "currency": "BRL",
    "credits_added": 5000,
    "approved_at": "2024-01-15T10:35:00Z"
  }
}

Listar Meus Pagamentos

GET/api/payment/my-payments

Lista todos os pagamentos do usuário autenticado.

Exemplo de Requisição

bash

curl -X GET "https://api.alauda.mz/api/payment/my-payments" \
  -H "X-API-Key: sua_api_key_aqui"

Resposta

json

{
  "success": true,
  "data": {
    "payments": [
      {
        "payment_id": "mp_1234567890",
        "provider": "mercadopago",
        "amount": 29.90,
        "currency": "BRL",
        "status": "approved",
        "credits_added": 5000,
        "created_at": "2024-01-15T10:30:00Z"
      },
      {
        "payment_id": "mpesa_abc123",
        "provider": "mpesa",
        "amount": 500,
        "currency": "MZN",
        "status": "approved",
        "credits_added": 3000,
        "created_at": "2024-01-10T14:20:00Z"
      }
    ],
    "total": 2
  }
}

Provedores Disponíveis

💙

MercadoPago

Brasil e América Latina. Aceita cartão de crédito, boleto e PIX.

🔴

M-Pesa

Vodacom Moçambique. Pagamento via carteira móvel (84xxxxxxx).

🟢

E-Mola

Movitel Moçambique. Pagamento via carteira móvel (86xxxxxxx / 87xxxxxxx).

💡

Créditos Automáticos

Os créditos são adicionados automaticamente à sua conta após o pagamento ser aprovado. Não é necessário nenhuma ação adicional.

⚠️

Importante

As rotas de pagamento não consomem créditos da API. Os créditos são adicionados à conta do usuário após o pagamento ser aprovado pelo provedor.