Agent Stripe 크레딧 충전 API

Agent Stripe Credit Top-Up API를 사용하면 AI 에이전트가 계정의 API 크레딧 잔액을 확인하고 사용자가 설정한 한도 내에서 계정에 저장된 Stripe 결제 수단으로 금액을 청구하여 계정 크레딧을 추가할 수 있습니다.

세 가지 주요 엔드포인트는 모두 다음 위치에 호스팅됩니다. payments.builtwith.com.

청구 구성 페이지에서 별도로 범위가 지정된 에이전트 청구 키를 복사하여 Authorization 헤더에 포함하여 전송하십시오. 일반 BuiltWith API 키와 임시 bw- 디바이스 토큰으로는 크레딧을 구매할 수 없습니다.

Authorization: Bearer YOUR_AGENT_BILLING_KEY

URL에 포함된 자격 증명이 로그 및 브라우저 기록에 남을 수 있으므로 기존 KEY 쿼리 매개변수는 더 이상 사용되지 않습니다.

키가 누락되었거나, 유효하지 않거나, 비활성화된 요청은 HTTP 401 오류를 반환합니다. 결제가 중단된 계정은 HTTP 403 오류를 반환합니다.

Reference https://api.builtwith.com/llms.txt and
https://raw.githubusercontent.com/builtwith/builtwith-ai-sdk/refs/heads/main/README.md
Add BuiltWith Agent Stripe Credit Top-Up API support to my app. This is saved-card
account billing, not x402. Check the account API-credit balance and, if below 1000,
purchase 2000 more using a unique Idempotency-Key and the scoped Agent Billing Key.
If the legacy mppx path aliases are desired, use
https://api.builtwith.com/mppx/openapi.json and the Agent Payment API routes
https://api.builtwith.com/mppx/api-discovery,
https://api.builtwith.com/mppx/api-configuration, and
https://api.builtwith.com/mppx/api-purchase.

이러한 기존 mppx 경로는 저장된 Stripe 결제 방식의 크레딧 충전 API를 프록시합니다. 이 경로는 x402 프록시가 아니며, payment-challenge 헤더를 반환하거나 수락하지 않습니다.

GET https://api.builtwith.com/mppx/openapi.json

GET https://api.builtwith.com/mppx/api-discovery

GET https://api.builtwith.com/mppx/api-configuration

POST https://api.builtwith.com/mppx/api-purchase

{ "credits": 2000 }

범위가 지정된 에이전트 청구 키를 인증 방식(베어러)으로 전송하고 구매 시 고유한 멱등성 키를 포함하십시오.

해당 계정의 현재 API 크레딧 잔액을 반환합니다.

GET https://payments.builtwith.com/v1/billing/api-discovery
Authorization: Bearer YOUR_AGENT_BILLING_KEY

{
  "credits_total": 10000,
  "credits_used": 1234,
  "credits_available": 8766
}

설정된 지출 한도와 월별 허용량 중 이미 사용된 금액을 반환합니다. 상담원은 구매를 시도하기 전에 이 값을 확인하여 요청 거절을 방지해야 합니다.

GET https://payments.builtwith.com/v1/billing/api-configuration
Authorization: Bearer YOUR_AGENT_BILLING_KEY

{
  "max_per_purchase": 5000,
  "max_monthly": 20000,
  "monthly_purchased": 5000,
  "monthly_remaining": 15000,
  "cost_per_2000_credits_usd": 99.00
}

사용자가 저장한 Stripe 결제 수단으로 요금이 청구되고 즉시 계정에 입금됩니다. 구매는 에이전트 API 결제 설정에서 지정된 구매당 및 월별 한도에 따라 제한됩니다.

POST https://payments.builtwith.com/v1/billing/api-purchase

범위가 지정된 에이전트 청구 키를 전송합니다. Authorization: Bearer YOUR_AGENT_BILLING_KEY, 그리고 고유한 것을 보내세요 Idempotency-Key. 동일한 구매를 다시 시도할 때만 해당 키를 재사용하십시오.

Authorization: Bearer YOUR_AGENT_BILLING_KEY
Idempotency-Key: 72b7b97c-3b6d-4c64-9bbf-20fd2a931514
Content-Type: application/json

{ "credits": 2000 }

{
  "success": true,
  "credits_purchased": 2000,
  "cost_usd": 99.00,
  "payment_id": "pi_3abc123xyz",
  "credits_available": 10766
}

이 형식의 오류 메시지는 보장할 수 없으며, 구현 시 200이 아닌 응답 코드도 오류로 간주해야 합니다. 오류가 서버 관련이면 Lookup 속성은 null(json)이 되거나 제공되지 않습니다(xml). 모든 잠재적인 잘 구성된 오류 코드 보기.

우리의 표준 용어 모든 API를 사용하는 것을 포함합니다.

일반적으로 API를 사용하여 제품을 다양한 방식으로 개선할 수 있습니다. 단, 데이터를 있는 그대로 재판매하거나 builtwith.com 및 관련 서비스에 중복된 기능을 제공할 수 없습니다.