인앱 결제

결제 상태 조회하기

post

생성된 결제건의 거래 상태와 거래 트랜잭션을 조회할 수 있어요. 상황에 따라, 승인 응답을 수신하지 못한 경우에도 활용할 수 있어요.

비즈니스 오류 코드

아래 오류는 HTTP 200과 resultType: FAIL로 응답해요.

errorCode	설명
4095	요청 한도를 초과했습니다. 잠시 후 다시 시도해주세요.

요청 한도: 앱당 분당 3,000회

Authorizations

mutualTLS

파트너에게 발급된 클라이언트 인증서 기반 mTLS 인증이에요. 인증서의 CN으로 미니앱을 식별해요. 인증서 발급·관리 방법은 서버 API 이용하기 문서를 참고하세요.

Body

인앱 결제 주문 상태 조회 요청 본문이에요.

orderIdstringRequired

조회할 인앱 결제 주문의 ID예요.

Example: a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7

Responses

200

인앱 결제 상태 조회에 성공했어요

application/json

or

400

요청 본문이 형식에 맞지 않아요. error.data.errorDetails에서 필드별 상세를 확인하세요.

application/json

500

분류되지 않은 서버 오류예요. 계속 실패하면 파트너 지원 채널로 문의해 주세요.

application/json

post/api-partner/v1/apps-in-toss/order/get-order-status

POST /api-partner/v1/apps-in-toss/order/get-order-status HTTP/1.1
Host: apps-in-toss-api.toss.im
Content-Type: application/json

{
  "orderId": "a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7"
}

{
  "resultType": "SUCCESS",
  "success": {
    "orderId": "a1b2c3d4-e5f6-4789-a0b1-c2d3e4f5a6b7",
    "reason": "구매가 완료됐어요.",
    "sku": "monthly_subscription",
    "status": "PURCHASED",
    "statusDeterminedAt": "2025-04-22T15:30:00"
  }
}