x402 결제

Minara에서 일회성, 사전 승인, 유료 MCP x402 결제를 사용합니다.

x402는 HTTP 402 Payment Required를 사용하는 개방형 결제 프로토콜입니다. 서비스는 계정이나 API Key 대신 가격과 온체인 결제 조건을 제시하고, Minara는 관리형 지갑으로 결제한 뒤 원래 요청을 다시 실행합니다.

핵심 개념

용어	의미
결제 요구 사항	서버가 선언한 수취인, 금액, 자산, 네트워크, 방식, 리소스입니다.
Exact	고정 금액 표준 방식입니다. EVM과 Solana의 등록된 결제 자산을 지원하며, 잔액이 충분한 옵션을 우선합니다. 조건이 같으면 USDC가 최우선입니다.
결제 서명	캡처된 한 챌린지 전용 증명이며 재사용 가능한 API 자격 증명이 아닙니다.
정산 응답	서비스 또는 Facilitator가 증명을 수락한 결과입니다.
사전 승인	Provider, 도메인 또는 판매자에 한정된 반복 결제 예산입니다.

챌린지는 사용자, 원래 요청, 판매자, 금액, 자산, 네트워크, 만료 시간에 바인딩되며 모델이 이를 바꿀 수 없습니다.

한 번 결제하기

Minara 데이터 도구, 유료 API 또는 MCP 도구를 호출합니다.
payment_required가 반환되면 Provider, 리소스, 자산과 금액, 네트워크, 수취 주소를 확인합니다.
결제를 승인합니다.
Minara가 x402 증명을 만들고 동일한 원래 호출을 한 번만 다시 실행합니다.
리소스 결과와 정산 또는 거래 상태를 확인합니다.

표준 및 레거시 결제

x402 v2 exact는 EVM EIP-3009/EIP-712 또는 Solana 토큰 전송 트랜잭션을 사용하고 PAYMENT-REQUIRED, PAYMENT-SIGNATURE, PAYMENT-RESPONSE 헤더로 데이터를 전달합니다.

이전 서비스가 transaction-hash proof와 이를 받을 HTTP 헤더를 명시할 수 있습니다. Minara는 retry_supported로 표시된 챌린지만 계속하며 금액, 수취인, 자산, 네트워크를 확인한 뒤 거래 해시를 연결하고 한 번만 재시도합니다. 안전한 증명 헤더가 선언되지 않으면 송금하지 않고 리소스를 해제할 수 있다고 안내하지 않습니다. 일반 HTTP 402에는 이 경로를 사용하지 않습니다.

반복 결제 사전 승인

Provider 또는 도메인 범위, 호출당 한도, 총 USDC 예산, 만료, 판매자 주소와 선택적 체인 제한을 설정합니다. /x402 preauth로 조회하거나 취소할 수 있습니다. 좁고 짧은 예산을 우선하세요.

유료 사용자 지정 MCP

Connectors → Add connectors → Add MCP server에서 MCP 서버를 추가합니다. 지갑 키나 결제 증명을 MCP 설정에 넣지 마세요. MCP 도구는 JSON-RPC로 x402 챌린지를 반환할 수 있고, 직접 원격 연결은 HTTP 402도 사용할 수 있습니다. JSON-RPC는 로컬 stdio에서도 사용할 수 있으며, HTTP 결제 헤더에는 직접 원격 연결 또는 그대로 전달하는 Broker가 필요합니다.

지원 범위와 문제 해결

x402 exact와 신뢰할 수 있는 결제 자산 레지스트리를 지원합니다. 지원 대상에는 EVM/Solana 네트워크의 공식 USDC와 X Layer의 USD₮0가 포함됩니다. 판매자가 받는 자산을 현재 보유 잔액과 대조하고 서명 전에 잔액을 다시 확인하며, 조건이 같으면 USDC를 우선합니다. upto, Permit2, aggr_deferred, 등록되지 않은 토큰은 지원하지 않습니다. 잔액이 부족하면 지정 네트워크에 자금을 넣고, 만료된 챌린지는 새로 요청하세요. 결과가 불확실하면 상태를 먼저 확인하고 중복 결제하지 마세요.

사용자 지정 MCP와 Connector 문제 해결도 참고하세요.