GETBearer 토큰

결제 상태 조회

/api/v1/payments/:id

결제 요청과 해당 주문 또는 잔액 충전 결과를 조회합니다.

호출 전 확인

온체인 또는 공급업체 처리 결과가 미정이면 같은 결제 요청을 계속 조회하세요. 다시 결제하거나 requestKey를 바꾸지 마세요.

API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.

요청 예시

cURL

curl "https://tovahub.com/api/v1/payments/507f1f77bcf86cd799439012" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.

응답 예시

JSON

{
  "id": "507f1f77bcf86cd799439011",
  "purpose": "order",
  "amount": "1200",
  "asset": "USD",
  "state": "quoted",
  "mode": null,
  "expiresAt": "2026-11-07T12:30:00.000Z",
  "transactionHash": null,
  "network": null,
  "result": null,
  "error": null
}

매개변수

id경로 · 필수

string

리소스 ID로, 24자리 16진수 문자열입니다. 공급업체 인스턴스 ID가 아니라 해당 목록 엔드포인트에서 반환한 플랫폼 ID를 사용하세요.

응답

HTTP 상태 200

조직에 이미 존재하는 결제 의도의 현재 영구 저장 상태를 조회합니다.

idstring (ObjectId)

결제 의도 식별자이며, 견적 식별자로도 사용합니다.

purposestring

결제 의도의 용도입니다. 현재 공개 생성 경로는 order 또는 deposit을 사용합니다. 저장된 용도는 renew일 수도 있지만 현재 갱신이 지원된다는 뜻은 아닙니다.

amountstring

정수 USD 센트입니다.

assetstring ('USD')

플랫폼 회계 자산입니다.

영구 저장된 결제 의도 상태입니다.

modestring ('balance' | 'x402') | null

선택한 결제 자금 출처 방식이며, 선택 전에는 null입니다.

expiresAtstring (ISO 8601)

견적 만료 시각입니다. 이미 수락한 자금은 이 시각 이후에도 대사 처리가 필요합니다.

transactionHashstring | null

블록체인 트랜잭션 해시이며, 있는 경우에만 제공됩니다.

networkstring | null

결제 네트워크이며, 있는 경우에만 제공됩니다.

resultunknown | null

용도별로 영구 저장된 처리 결과입니다. 공통 중첩 응답 스키마는 정의되어 있지 않습니다.

errorstring | null

영구 저장된 결제 오류이며, 있는 경우에만 제공됩니다.

요청과 오류 인증 MCP · get_payment

결제 상태 조회

요청 예시

매개변수#

응답#

관련 항목#

매개변수

응답

관련 항목