Markdown으로 복사

연동 가이드

운영 정보

결제 결과 구분

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

운영 주소

용도	주소
본인인증 화면	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에 점검 시작·종료 시각과 시간대가 담깁니다.

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을 사용하세요. 결제 세션 생성이 거절됐다면 종료 시각 이후 다시 요청하세요.

배포 전 확인 항목은 라이브 전환 체크리스트, 문제가 생겼을 때의 확인 방법과 문의는 문제 해결을 참고하세요.