Criar contexto
Descreva o pedido, a sessão, a evidência ou a tarefa do agente separadamente dos fatos do pagamento.
Solicite pagamento sem assumir o controle da carteira.
Crie uma Payment Request padrão, anexe o contexto do negócio, permita que o cliente revise e assine localmente, e depois acompanhe o resultado por meio de um modelo de status consistente.
Official Testnet integration is open for supported flows. Mainnet settlement, commercial pricing, and service-level commitments are not offered.
Um limite mais claro
Seu sistema solicita. A carteira do cliente decide.
O VelarumPay mantém distintos os sistemas do comerciante, os sistemas do agente e as responsabilidades de assinatura da carteira.
Solicitar pagamento
Envie um valor exato, ativo, rede, destinatário, expiração e chave de idempotência.
O usuário aprova
O cliente revisa os riscos e os fatos da transação antes de assinar em seu dispositivo.
Observar status
Sua integração lê status e eventos determinísticos sem ganhar autoridade de assinatura.
Caminhos de integração
Um protocolo, várias formas de conectar.
Escolha a interface que se encaixa na sua aplicação. Todo caminho suportado converge para velarum.payment_request.v1.
Integre diretamente com a Platform API.
Use o contrato OpenAPI publicado para pareamento, conexões, contextos de transação, Payment Requests, status e eventos. Os serviços no lado do servidor validam escopos, expiração, valores exatos e idempotência.
Use helpers tipados em torno dos mesmos contratos.
O JavaScript SDK reúne pareamento, validação, criação de contexto, criação de Payment Request e consulta de status em uma superfície de cliente menor. A API e o JSON Schema continuam sendo a fonte da verdade.
Dê aos agentes ferramentas de solicitação, nunca chaves da carteira.
O servidor MCP e os conectores expõem um conjunto deliberadamente pequeno de ferramentas para pareamento, criação de contexto, solicitação de pagamento e leitura de status. Eles não podem aprovar, assinar, exportar chaves nem contornar a revisão da carteira.
Adequação à Official Testnet
Comece onde o modelo de controle importa.
Uma integração compatível deve ter usuário, solicitante, motivo de pagamento e fluxo de aprovação testável claramente definidos.
Checkout do comerciante
Avalie o pareamento da carteira e as solicitações de pagamento a partir de um fluxo de pedido sem pedir ao comerciante para lidar com as chaves do usuário.
Aplicações confiáveis
Conecte software que precisa de pagamentos aprovados pelo usuário e status auditável, sem autoridade custodial.
Fluxos de trabalho de agentes de IA
Permita que um agente local ou hospedado proponha uma compra, preservando a validação determinística e a aprovação humana.
O que sua integração deve preservar
Fatos claros, escopos limitados e estado observável.
Uma boa integração facilita ao usuário da carteira verificar a solicitação e à sua equipe diagnosticar o resultado.
- Strings decimais exatas de valor e identidade explícita do ativo
- Controles de rede, destinatário, taxa, expiração e idempotência
- Contexto da transação separado dos fatos imutáveis do pagamento
- Escopos limitados às capacidades de que sua aplicação realmente precisa
- Tratamento seguro de tokens de conexão e estados de erro determinísticos
- Nenhuma chave privada, frase de recuperação ou material de assinatura no seu serviço
Official Testnet integration support
Tell us what you want to integrate.
Share your use case, integration surface, intended user approval flow, and test environment. This support request does not grant mainnet or commercial production access.
Sem dados sensíveisNão inclua chaves de API, endereços de carteira, frases de recuperação, chaves privadas, dados de clientes de produção nem material de assinatura.
Prefere inspecionar os contratos primeiro?
O subdomínio de desenvolvedor contém o Quickstart, a superfície REST, os schemas do protocolo e o guia MCP.