컨텍스트 생성
주문, 세션, 증빙, 또는 에이전트 작업은 결제 사실과 분리해서 설명하세요.
지갑의 통제권을 가져가지 않고 결제를 요청하세요.
표준 Payment Request를 생성하고 비즈니스 컨텍스트를 첨부한 뒤, 고객이 로컬에서 검토하고 서명하게 하고, 이후 일관된 상태 모델로 결과를 추적하세요.
Official Testnet integration is open for supported flows. Mainnet settlement, commercial pricing, and service-level commitments are not offered.
더 명확한 경계
귀하의 시스템은 요청하고, 고객의 지갑이 결정합니다.
VelarumPay는 판매자 시스템, 에이전트 시스템, 지갑 서명 책임을 명확히 구분합니다.
결제 요청
정확한 금액, 자산, 네트워크, 수취인, 만료, 멱등성 키를 보내세요.
사용자 승인
고객은 자신의 기기에서 서명하기 전에 위험과 거래 사실을 검토합니다.
상태 확인
귀하의 통합은 서명 권한을 얻지 않고 결정론적 상태와 이벤트를 읽습니다.
통합 경로
하나의 프로토콜, 여러 연결 방식.
애플리케이션에 맞는 인터페이스를 선택하세요. 지원되는 모든 경로는 다음으로 수렴합니다. velarum.payment_request.v1.
Platform API와 직접 통합하세요.
공개된 OpenAPI 계약을 사용해 페어링, 연결, 거래 컨텍스트, Payment Requests, 상태, 이벤트를 처리하세요. 서버 측 서비스는 범위, 만료, 정확한 금액, 멱등성을 검증합니다.
같은 계약을 기반으로 한 typed helper를 사용하세요.
JavaScript SDK는 페어링, 검증, 컨텍스트 생성, Payment Request 생성, 상태 폴링을 더 작은 클라이언트 인터페이스로 묶어 제공합니다. API와 JSON Schema는 여전히 기준이 되는 원본입니다.
에이전트에는 요청 도구만 주고, 지갑 키는 절대 주지 마세요.
MCP 서버와 커넥터는 페어링, 컨텍스트 생성, 결제 요청, 상태 읽기를 위한 의도적으로 작은 도구 집합만 제공합니다. 이들은 승인, 서명, 키 내보내기, 지갑 검토 우회를 할 수 없습니다.
Official Testnet 적용 범위
통제 모델이 중요한 지점에서 시작하세요.
지원되는 통합에는 명확한 사용자, 요청자, 결제 사유 및 테스트 가능한 승인 흐름이 있어야 합니다.
판매자 체크아웃
판매자가 사용자 키를 다루지 않도록 하면서 주문 흐름에서 지갑 페어링과 결제 요청을 평가하세요.
신뢰하는 애플리케이션
수탁 권한 없이 사용자 승인 결제와 감사 가능한 상태가 필요한 소프트웨어를 연결하세요.
AI 에이전트 워크플로
결정론적 검증과 사람의 승인을 유지한 채 로컬 또는 호스팅된 에이전트가 구매를 제안하게 하세요.
통합이 반드시 유지해야 하는 것
명확한 사실, 제한된 범위, 관찰 가능한 상태.
좋은 통합은 지갑 사용자가 요청을 쉽게 검토할 수 있게 하고, 귀하의 팀이 결과를 쉽게 진단할 수 있게 합니다.
- 정확한 소수 금액 문자열 및 명시적 자산 식별
- 네트워크, 수취인, 수수료, 만료, 멱등성 제어
- 거래 컨텍스트는 변경 불가능한 결제 사실과 분리됨
- 애플리케이션에 실제로 필요한 기능으로만 제한된 범위
- 연결 토큰과 결정론적 오류 상태의 안전한 처리
- 귀하의 서비스에 개인 키, 시드 구문, 서명 자료를 두지 마세요
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.
민감한 데이터 없음API 키, 지갑 주소, 시드 구문, 개인 키, 운영 고객 데이터, 서명 자료는 포함하지 마세요.