VietQR Pagamentos para Agentes de IA—Sem Configuração do Stripe

O Problema

Construindo agentes de IA no Vietnã que precisam coletar pagamentos? O Stripe não suporta VietQR, e integrar gateways de pagamento tradicionais significa gerenciar chaves de API, webhooks e atrasos na liquidação de fundos. A maioria das soluções exige que seu agente mantenha ou roteie dinheiro através de intermediários.

E se sua IA pudesse gerar um código QR que aponta diretamente para a conta bancária da sua empresa?

Apresentando o AgentPay VN

AgentPay é um SDK Python de código aberto (MIT) + servidor MCP que permite que Claude, LLMs locais e agentes personalizados coletem pagamentos VietQR em três linhas de lógica:

Criar um pedido de pagamento
Enviar a URL de checkout para seu cliente
Aguardar a confirmação de liquidação do feed bancário

Sem intermediários. Sem retenção de fundos. O QR aponta diretamente para sua conta de comerciante.

Como Funciona

O AgentPay lê o feed SePay do seu banco para confirmar quando um pagamento é liquidado. Ele não toca no dinheiro—apenas observa. Seu agente de IA pode então acionar fluxos de trabalho subsequentes (enviar fatura, desbloquear recurso, etc.) assim que a liquidação for confirmada.

Instalação

pip install agentpay-vn

Ou execute o servidor MCP para Claude Desktop / Code:

pip install agentpay-mcp

Exemplo Rápido

from agentpay import AgentPayClient

client = AgentPayClient(
    api_key="sua_chave_api",
    merchant_id="seu_id_comerciante"
)

# Passo 1: Criar pedido de pagamento
payment = client.create_payment_request(
    amount=100000,  # 100K VND
    description="sessão de consultoria de IA",
    order_id="pedido_12345"
)

print(f"URL de Checkout: {payment.checkout_url}")
# Compartilhe com o cliente → ele escaneia o QR → o dinheiro vai para seu banco
# Passo 2: Polling para liquidação
import time
while True:
    status = client.get_payment_status(payment.id)
    if status.settled:
        print("✓ Pagamento confirmado! Acionando fluxo de trabalho subsequente...")
        break
    time.sleep(5)

Integração MCP

Adicione à sua configuração do Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "agentpay": {
      "command": "python",
      "args": ["-m", "agentpay_mcp.server"],
      "env": {
        "AGENTPAY_API_KEY": "sua_chave_api",
        "AGENTPAY_MERCHANT_ID": "seu_id_comerciante"
      }
    }
  }
}

Agora Claude pode:

Gerar códigos QR de pagamento sob demanda
Verificar o status da liquidação durante a conversa
Encadear pagamentos em fluxos de trabalho de múltiplas etapas

Casos de Uso Reais

Chatbots de Consultoria de IA: "Essa análise custará ₫500K. [Escaneie o QR]. Obrigado! Aqui está seu relatório."
Robôs de Negociação Autônomos: Coletar taxas quando as negociações são executadas; liquidar diretamente na conta de operações.
Marketplace de Conteúdo de IA: O agente lista conteúdo, coleta micropagamentos, divide a receita—tudo via QR.

Limitações Honestamente

Apenas Vietnã: Requer uma conta bancária compatível com VietQR.
Dependência do SePay: A confirmação da liquidação depende da API do feed SePay do seu banco (nem todos os bancos são totalmente suportados ainda—verifique a documentação).
Modelo de Polling: Sem webhooks em tempo real; você fará polling para atualizações de status.
Estágio Inicial: Projeto de código aberto; o uso em produção deve incluir seu próprio monitoramento.

Comece

GitHub: https://github.com/phuocdu/agentpay-vn
Documentos + Swagger: https://agentpay.servicesai.vn
Referência da API: https://agentpay.servicesai.vn/v1/docs

O AgentPay elimina a complexidade da infraestrutura de pagamentos para que você possa se concentrar no que seu agente de IA faz de melhor. Sem Stripe. Sem complicações.