# 운영 정보

## 결제 결과 구분

| 구분           | 판단 기준                                                                      | 처리 방법                                |
| -------------- | ------------------------------------------------------------------------------ | ---------------------------------------- |
| 사용자 종료    | SDK 실패 URL의 `PAYMENT_WINDOW_CLOSED`                                      | 결제 승인 없이 종료                      |
| 연동 오류      | SDK·메시지 필수값 누락, 세션 불일치 또는 API 인증·권한·요청 형식 오류          | 설정과 요청값 확인                       |
| 결제 실패      | 결제 승인 API가 명시적인 실패 응답 반환                                        | 실패 화면 표시                           |
| 결과 확인 필요 | 응답 대기 시간 초과, 네트워크 오류, 응답 누락 또는 세션 불일치                 | 성공·실패로 표시하지 않고 결제 내역 확인 |
| 결제 성공      | 승인 응답 또는 결제 세션 조회 결과가 `status: captured`                        | 주문 성공 처리                           |

<Callout type="caution" title="확인되지 않은 결과를 실패로 처리하지 마세요">
  결제 결과를 확인할 수 없다면 같은 주문을 바로 다시 결제하거나 상품을 지급하지 마세요. 주문 상태와 결제 내역을 먼저
  확인하세요.
</Callout>

## 운영 주소

| 용도 | 주소 |
| --- | --- |
| 본인인증 화면 | `https://auth.point3.io/` |
| 결제 화면 | `https://widget.point3.io` |
| JavaScript SDK | `https://widget.point3.io/v2/standard` |
| 결제 세션 생성 | `POST https://api.point3.io/payment/v3/session` |
| 결제 세션 조회 | `GET https://api.point3.io/payment/v3/session/{sessionId}` |
| 결제 승인 | `POST https://api.point3.io/capture/v2/{sessionId}` |
| 결제 취소 상태 조회 | `GET https://api.point3.io/refunds/v1/{sessionId}` |
| 결제 취소 | `POST https://api.point3.io/refunds/v1/{sessionId}` |
| 결제 취소 처리 재개 | `POST https://api.point3.io/refunds/v1/{sessionId}/resume` |

## EOB 점검 시간

매일 **23:30부터 다음 날 00:30까지** (KST, 한국 표준시)는 점검 시간으로, 결제 세션 생성과 결제 진행이 제한됩니다. 00:30부터 다시 이용할 수 있습니다.

구매자에게는 “시스템 점검 중입니다. 9월 16일 00:30 이후 다시 이용해주세요.”처럼 종료 시각을 안내하세요.

점검 중에는 HTTP `503` 응답의 `error.eob`에 점검 시작·종료 시각과 시간대가 담깁니다.

```json title="2026-09-16 00:10(KST)에 반환되는 예"
{
  "error": {
    "type": "serviceUnavailableError",
    "code": "temporarilyUnavailable",
    "message": "시스템 점검 시간에는 결제를 진행할 수 없습니다. 2026-09-16T00:30:00+09:00 (Asia/Seoul) 이후 다시 시도해주세요.",
    "eob": {
      "startsAt": "2026-09-15T23:30:00+09:00",
      "endsAt": "2026-09-16T00:30:00+09:00",
      "timeZone": "Asia/Seoul"
    }
  }
}
```

`startsAt`은 점검 시작 시각, `endsAt`은 이용 재개 시각입니다. 구매자 안내에는 `endsAt`과 `timeZone`을 사용하세요. 결제 세션 생성이 거절됐다면 종료 시각 이후 다시 요청하세요.

배포 전 확인 항목은 [라이브 전환 체크리스트](/go-live-checklist), 문제가 생겼을 때의 확인 방법과 문의는 [문제 해결](/troubleshooting)을 참고하세요.