ovahub팀 USD 잔액으로 견적 구매
/api/v1/orders/buy
토큰에 고정된 팀의 USD 잔액만으로 본인이 만든 유효한 주문 견적을 구매합니다. 성공 시 HTTP 202와 applied/balance 상태의 결제 정보를 반환하며 서버 인도 완료를 뜻하지 않습니다. 같은 견적을 재시도하면 원래 결과를 반환합니다.
호출 전 확인
API 구매는 기본적으로 꺼져 있습니다. 팀의 기존 미회수 서버에 연결된 티켓으로 관리자에게 특정 토큰 활성화를 요청하세요. USD 부족 시 409로 거부하며 x402, 충전, xTOVA 또는 수수료 잔액으로 전환하지 않습니다. 결과가 불확실하면 같은 견적 ID를 유지하고 get_payment와 get_order를 조회하세요. MCP 구매는 이 설정의 제한을 받지 않습니다. 다른 토큰이나 새 토큰은 권한을 상속하지 않습니다.
API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.
요청 예시
curl "https://tovahub.com/api/v1/orders/buy" -X POST \
-H "Authorization: Bearer $TOVAHUB_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"id": "507f1f77bcf86cd799439011"
}'예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.
응답 예시
{
"id": "507f1f77bcf86cd799439011",
"purpose": "order",
"amount": "1200",
"asset": "USD",
"state": "applied",
"mode": "balance",
"expiresAt": "2026-11-07T12:30:00.000Z",
"transactionHash": null,
"network": null,
"result": {
"_id": "507f1f77bcf86cd799439012",
"status": "pending"
},
"error": null
}매개변수
idJSON 본문 · 필수string
quote_vps_order가 반환한 견적 또는 결제 정보 ID로 정확히 24자의 16진수입니다. 원래 작성자만 같은 고정 팀에서 구매할 수 있습니다. 다른 필드는 보내지 마세요.
응답
HTTP 상태 202
재시도하면 접수된 동일 주문 결과를 반환합니다. 접수는 서버 인도 완료를 의미하지 않습니다.
idstring (ObjectId)결제 의도 식별자이며, 견적 식별자로도 사용합니다.
purpose"order"결제 의도의 용도입니다. 현재 공개 생성 경로는 order 또는 deposit을 사용합니다. 저장된 용도는 renew일 수도 있지만 현재 갱신이 지원된다는 뜻은 아닙니다.
amountstring정수 USD 센트입니다.
assetstring ('USD')플랫폼 회계 자산입니다.
state"applied"영구 저장된 결제 의도 상태입니다.
mode"balance"선택한 결제 자금 출처 방식이며, 선택 전에는 null입니다.
expiresAtstring (ISO 8601)견적 만료 시각입니다. 이미 수락한 자금은 이 시각 이후에도 대사 처리가 필요합니다.
transactionHashnull블록체인 트랜잭션 해시이며, 있는 경우에만 제공됩니다.
networknull결제 네트워크이며, 있는 경우에만 제공됩니다.
resultunknown | null용도별로 영구 저장된 처리 결과입니다. 공통 중첩 응답 스키마는 정의되어 있지 않습니다.
errornull영구 저장된 결제 오류이며, 있는 경우에만 제공됩니다.