Agentes IA · Servidor MCP

API Developer de Faturação

Todas as ferramentas do MCP são, por baixo, chamadas a endpoints REST. Esta página documenta-os para quem quiser usá-los diretamente — num script de CI, numa ferramenta própria, ou simplesmente para perceber o que o assistente está a fazer.

Porque existe uma API separada

A API de pagamentos de produção é M2M: exige um token client_credentials, e portanto o client_secret da app. Uma ferramenta de desenvolvimento não o tem, e obrigá-la a rodá-lo invalidaria o segredo que a tua aplicação já usa em produção.

Existe por isso um espelho autenticado pelo Personal Access Token do dono da app. É deliberadamente mais restritivo do que a API M2M: nada aqui gera uma cobrança real.

Autenticação

curl https://api.acapadev.com/v1/developer/apps \
  -H "Authorization: Bearer O_TEU_PAT" \
  -H "Accept: application/json"

Endpoints

Descoberta e configuração

Faturação

Webhooks

Gestão pós-venda

Exemplo: o loop de validação em curl

# 1. Configurar o webhook e subscrever o evento
curl -X PUT https://api.acapadev.com/v1/developer/apps/7/payment-config \
  -H "Authorization: Bearer $PAT" \
  -H "Content-Type: application/json" \
  -d '{"billing_webhook_url":"https://minhaloja.ao/api/webhooks/billing","subscribe_invoice_paid":true}'

# 2. Disparar um invoice.paid de teste e ver como o teu código respondeu
curl -X POST https://api.acapadev.com/v1/developer/apps/7/webhooks/test-billing \
  -H "Authorization: Bearer $PAT" \
  -H "Content-Type: application/json" \
  -d '{"total":5000,"currency":"AOA","app_reference":"order_1234"}'

A resposta traz a entrega registada, com o estado HTTP e o corpo devolvidos pelo teu endpoint:

{
  "status": "success",
  "data": {
    "target_url": "https://minhaloja.ao/api/webhooks/billing",
    "signature_header": "X-AcapaDev-Signature",
    "signature_algorithm": "hash_hmac('sha256', json_encode($payload), $webhook_secret)",
    "payload_sent": { "...": "..." },
    "delivery": { "status": "success", "response_status": 200, "response_body": "" }
  }
}

Códigos de erro