메인 콘텐츠로 건너뛰기
POST
/
api
/
v1
/
x402
/
pay
x402 Pay
curl --request POST \
  --url https://api.agentwallex.com/api/v1/x402/pay \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "agent_id": "agent_abc123",
  "target_url": "https://paid-api.example.com/v1/data",
  "session_id": "sess_xyz789",
  "chain": "eip155:84532"
}
'
{
  "ledger_id": "ldg_abc123",
  "amount": "0.10",
  "fee_amount": "0.002",
  "fee_rate": "2.0",
  "token": "USDC",
  "chain": "eip155:84532",
  "status": "completed",
  "payment_signature": "base64_encoded_signature..."
}

Documentation Index

Fetch the complete documentation index at: https://docs.agentwallex.com/llms.txt

Use this file to discover all available pages before exploring further.

대상 URL에 대한 하나의 x402 결제를 협상하고 완료합니다. AgentWallex는 에이전트의 정책을 평가하고, MPC를 통해 결제에 서명하며, 유료 리소스에 접근하는 데 필요한 결제 정보를 반환합니다.

​
요청 본문

​
agent_id
string
필수
결제에 자금을 제공할 에이전트.
​
target_url
string
필수
결제할 x402 지원 URL (예: https://paid-api.example.com/v1/data).
​
session_id
string
기존 세션 예산에서 차감하기 위한 선택적 세션 ID. x402 세션을 참조하세요.
​
chain
string
결제 정산을 위한 CAIP-2 체인 식별자 (예: eip155:84532). 생략하면 에이전트의 기본 체인이 사용됩니다.

​
응답

​
예시

curl -X POST https://api.agentwallex.com/api/v1/x402/pay \
  -H "X-API-Key: awx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agent_abc123",
    "target_url": "https://paid-api.example.com/v1/data",
    "session_id": "sess_xyz789",
    "chain": "eip155:84532"
  }'
Response
{
  "ledger_id": "ldg_abc123",
  "amount": "0.10",
  "fee_amount": "0.002",
  "fee_rate": "2.0",
  "token": "USDC",
  "chain": "eip155:84532",
  "status": "completed",
  "payment_signature": "base64_encoded_signature..."
}

​
관련 엔드포인트

엔드포인트설명
POST /x402/checkURL이 x402 결제 협상을 지원하는지 확인
POST /x402/facilitator/verify결제 서명 검증 (서비스 프로바이더용)
POST /x402/facilitator/settle검증된 결제 정산 (서비스 프로바이더용)
GET /x402/facilitator/supportedx402 지원 체인 목록 조회
GET /x402/fees/tiers현재 수수료 등급 일정 조회

인증

​
X-API-Key
string
header
필수

API key authentication. Keys are prefixed with awx_.

본문

application/json
​
agent_id
string
필수

The agent whose wallet will fund the payment.

​
target_url
string<uri>
필수

The x402-enabled URL to pay for (e.g., https://paid-api.example.com/v1/data).

​
session_id
string

Optional session ID to deduct from an existing session budget.

​
chain
string

CAIP-2 chain identifier for payment settlement (e.g., eip155:84532). If omitted, the agent's default chain is used.

응답

Payment completed successfully.

Result of an x402 payment negotiation.

​
ledger_id
string

Internal ledger entry ID for this payment.

​
amount
string

Payment amount.

​
fee_amount
string

Platform fee deducted.

​
fee_rate
string

Fee percentage applied (based on tiered pricing).

​
token
string

Token used for payment (e.g., USDC).

​
chain
string

Chain used for settlement.

​
status
enum<string>

Payment status.

사용 가능한 옵션:
completed,
pending,
failed
​
payment_signature
string

The PAYMENT-SIGNATURE value to include in the retry request to the target URL.