지급
Updated:
모든 유료 엔드포인트는 x402 프로토콜의 동일한 2단계 요청 주기를 따릅니다. 첫 번째 요청은 가격을 반환하고, 두 번째 요청은 대금을 결제합니다.
작업 흐름
견적 요청
POST /orders(또는/renew,/traffic,/topup) 결제 관련 문구 제외반환값
402 Payment Required: 본문의 인용문과 결제 요건은PAYMENT-REQUIRED헤더. 예약되거나 청구되는 항목은 없습니다.승인 서명
EIP-3009 transferWithAuthorization정확히 USDC 이체 금액에 서명하십시오.
amounttopayTo지갑을 통해. 서명만으로는 자금이 이체되지 않습니다.서명과 함께 요청을 다시 보내주세요.
동일한 방법, 경로 및 본문 내용에 다음을 추가합니다.
PAYMENT-SIGNATURE반환값
202 Accepted작업 ID, 해당 상태, 그리고 신규 주문 및 충전 건의 경우 액세스 토큰을 포함합니다.PAYMENT-RESPONSE헤더가 트랜잭션을 전달합니다.결과 조사
GET /orders/{id}또는GET /topup/{id}결제는 먼저 네트워크에서 확인된 후, 해당 작업이 처리됩니다. 매
next_poll_after_seconds~까지status_is_terminalistrue.
시작하기 전에
Base에 USDC가 들어 있는 지갑 — 결제자. 가스비로 ETH가 필요하지 않습니다.
x402 클라이언트 — x402 버전 2가 탑재된 모든 클라이언트, 즉
exactscheme 및 EIP-3009, 또는 직접 작성한 코드 (결제 관련 제목).현재 용어 — 다음 버전의
catalog.terms자세히 알아보기accept_terms새로운 주문에 대한.
모든 유료 엔드포인트에 공통적으로 적용되는 사항
기본 URL
https://proxy-seller.com/api/x402/v1결제 절차
x402 버전 2, 스킴 exact, 전송 방식 EIP-3009, 흐름 upfront: 주문이 처리되기 전에 결제를 완료해야 합니다. 버전 1 헤더 X-PAYMENT 는 기각되었습니다.
인용문
인용문은 15분 동안만 유효합니다 (quote_expires_at). 유료 의뢰는 무상 의뢰의 본문 내용을 그대로 반복해야 하며, 오직 idempotency_key, callback_url 그리고 auto_renew 다를 수 있습니다.
오류 모델
실제 HTTP 상태 코드와 JSON 본문에는 retry_action 다음에 무엇을 해야 하는지 알려주는 (오류).
유료 엔드포인트
엔드포인트 | 제공되는 서비스 | 결제 가능 대상 |
|---|---|---|
| 새로운 주문 | 어떤 지갑이든 상관없으며, 해당 지갑이 주문의 소유자가 됩니다. |
| 주문 내역 갱신 | 주문을 결제한 지갑만 |
| 일반 트래픽 | 주문을 결제한 지갑만 |
| 자동 갱신용 충전 잔액 | 어떤 지갑이든 상관없으며, 이 지갑의 잔액이 적립됩니다. |
소요 시간
다음과 같이 202 답변: Base 네트워크에서 결제가 확인되면 주문이 처리됩니다. 프록시는 보통 몇 분 이내에 준비됩니다. 모바일 프록시는 당사 직원이 수동으로 발급하므로 최대 3시간까지 소요될 수 있습니다.
유료 거래는 절대 손실되지 않습니다. 단계 중 하나에서 오류가 발생하면 거래가 당사 직원의 처리를 기다리며, 요금이 이중으로 청구되지 않습니다.
결제를 완료한 후
자주 묻는 질문(FAQ)
아니요. 서명된 승인서는 귀하를 대신하여 네트워크에 제출됩니다.
새로운 견적을 요청하세요. 만료된 견적이 포함된 서명된 요청서를 이미 보낸 경우, 응답 메시지에 다음 조치 사항이 안내되어 있습니다: 402 quote_expired 응답에 바로 새로운 인용문이 포함되어 있습니다; 409 payment_not_settleable 이는 이전 승인이 여전히 실행될 수 있음을 의미하므로, 다음까지 기다리십시오. authorization_expires_at 새로운 계약에 서명하기 전에.
아니요. 하나의 인증은 네트워크에서 한 번만 실행될 수 있으며, 동일한 인증을 반복하면 PAYMENT-SIGNATURE 첫 번째 시도의 결과를 반환합니다. 이전 권한 부여가 아직 실행 가능한 동안에는 새로운 권한 부여에 서명하지 마십시오. 오류 응답에는 기한이 명시되어 있습니다(authorization_expires_at).
동일한 요청을 동일한 PAYMENT-SIGNATURE. 안전합니다: 첫 번째 시도에서 바로 결과를 얻을 수 있습니다.
API를 통해서는 안 됩니다. 문의해 주십시오. [email protected] 주문 ID와 함께.
해당 주소가 있는 경우, 카탈로그에는 다음과 같이 게재됩니다. protocol.sandbox_url.