OKX로 AI agent가 직접결제하고 가입하게 하세요

OKX Wallet으로 x402 결제를 하고 한 번의 요청으로 API key와 잔액을 받습니다.

X Layer의 USD₮0, OKX를 통해 정산
신용카드와 가입 양식이 필요 없음
일반 사용자도 x402로 충전 가능

결제 없이 가입을 요청합니다. 402 응답에 서버가 받는 조건이 나옵니다.

요청

curl -i -X POST https://bazaarlink.ai/api/v1/agents/register/x402 \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","amountUsd":1.1}'

응답 예시샘플 데이터

HTTP/1.1 402 Payment Required
Content-Type: application/json

{
  "x402Version": 2,
  "resource": {
    "url": "https://bazaarlink.ai/api/v1/agents/register/x402",
    "description": "BazaarLink paid agent registration",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:196",
      "payTo": "0xPAY_TO_ADDRESS",
      "asset": "0xASSET_CONTRACT",
      "amount": "1100000",
      "maxTimeoutSeconds": 300,
      "extra": { "name": "USD₮0", "version": "1" }
    }
  ]
}

/x402

x402란 무엇인가요

POST/api/v1/agents/register/x402
← 402accepts[ network, asset, amount, payTo ]
signEIP-3009
POSTX-PAYMENT: …
← 201api_key, credits, claim_token

결제는 OKX의 x402 facilitator를 통해 X Layer에서 정산되며 서버는 처리 전에 매번 확인합니다.

HTTP 402로 결제 요청

서버는 402를 반환하고 허용하는 네트워크, 자산, 금액, 수신 주소를 보여 줍니다. 클라이언트는 결제 승인에 서명한 뒤 같은 요청을 다시 보냅니다. BazaarLink는 OKX의 x402 facilitator를 통해 X Layer에서 각 결제를 정산합니다.

api_keysk-bl-…

credits5

claim_token…

payment.txHash0x…

먼저 계정이 필요 없음

agent는 미리 양식을 작성하거나 계정을 만들 필요가 없습니다. 결제가 담긴 요청이 계정을 만들고 API key를 발급하며 잔액을 추가합니다.

/register

요청부터 API key까지 네 단계

요청 보내기

/api/v1/agents/register/x402로 POST하고 이름과 결제할 달러 금액을 보냅니다.

402 받기

서버가 402와 결제 조건을 답합니다. 이 시점에는 아무것도 생성되지 않습니다.

서명하고 다시 보내기

자신의 지갑으로 결제 승인에 서명하고 X-PAYMENT 헤더에 넣어 같은 요청을 다시 보냅니다.

API key 받기

결제가 확인되면 API key, 잔액, 인수 링크가 담긴 201을 받습니다. API key는 이 응답에서만 표시되므로 즉시 저장하세요.

/topup

이미 계정이 있나요? x402로도 충전하세요

agent는 기존 API key를 사용합니다. 일반 사용자는 로그인 후 크레딧 페이지에서 충전합니다.

Agent와 스크립트

Authorization 헤더와 amountUsd를 넣어 /api/x402/topup으로 POST합니다. 가입과 같은 흐름인 견적, 서명, 재전송입니다.

일반 사용자

로그인하고 크레딧 페이지에서 x402를 선택한 뒤 브라우저 지갑으로 결제에 서명합니다.

/network

지원 네트워크와 자산

현재 한 가지 조합을 지원합니다.

네트워크: X Layer, OKX의 x402 facilitator를 통해 정산
자산: USD₮0
잔액: 플랫폼 충전 수수료가 적용되므로 입금되는 잔액은 결제 금액보다 적습니다(요금 안내 참조)
결제 금액: 최소·최대 금액이 있으며 현재 한도는 402 응답과 GET /api/x402/topup에서 확인합니다

온체인 결제는 되돌릴 수 없습니다. 서명하기 전에 금액과 네트워크를 확인하세요.

아직 결제하지 않았나요? 무료 모델은 계속 사용 가능

결제하지 않은 agent 계정은 기존 무료 모델 할당량과 속도 제한(auto:free)을 사용합니다. 결제 후에는 일반 유료 계정 규칙을 따릅니다.

/faq

자주 묻는 질문

x402가 무엇인가요?

x402는 HTTP 402 상태 코드로 결제를 요청하는 프로토콜입니다. 서버가 금액, 네트워크, 수신 주소를 알리고 클라이언트가 결제 승인에 서명한 뒤 같은 요청을 다시 보냅니다.

x402로 결제하려면 무엇이 필요한가요?

OKX Wallet 또는 EIP-3009 승인에 서명할 수 있는 지갑 키와 X Layer의 USD₮0가 필요합니다. 연동 문서에 x402 클라이언트로 서명하는 TypeScript 코드가 있습니다.

어떤 네트워크와 자산을 지원하나요?

X Layer의 USD₮0이며 OKX의 x402 facilitator를 통해 정산됩니다. 플랫폼 충전 수수료가 적용되므로 받는 잔액은 결제 금액보다 적습니다. 요금 안내를 확인하세요.

두 번 결제하거나 다시 보내면 어떻게 되나요?

각 결제는 한 번만 적립됩니다. 충전에서 같은 결제를 다시 보내면 already_credited가 반환됩니다. 가입은 15분 동안 같은 결과를 반환하고, 그 후에는 already_registered가 반환되며 API key는 다시 표시되지 않습니다.

환불받을 수 있나요?

온체인 결제는 되돌릴 수 없고 시스템이 자동으로 환불하지도 않습니다. 문제가 생기면 지원팀에 문의하세요.

가입 횟수에 제한이 있나요?

있습니다. 같은 네트워크 출처의 가입은 짧은 기간 동안 제한됩니다. 한도에 도달하면 429와 Retry-After 헤더를 받으므로 기다렸다가 다시 시도하세요.

사람이 agent 계정을 인수할 수 있나요?

가능합니다. 가입 응답에 claim_token과 upgrade_url이 포함됩니다. 사람이 로그인해 계정을 인수하면 API key와 잔액이 그 계정으로 이동하며 claim_expires가 기한을 알려 줍니다.

agent가
결제를 직접 처리하게 하세요

연동 문서 읽기

복사됨