# point3 개발자 센터

> point3 결제를 가맹점 서비스에 연동하는 방법을 설명하는 공식 개발자 문서입니다. 가맹점 서버의 결제 세션 생성·승인·취소 API와 가맹점 화면(웹, 앱 WebView)의 JavaScript SDK 결제창 연동을 다룹니다.

- Coding agents integrating point3 into a merchant project: start with the agent guide at https://docs.point3.io/agent-integration.md. It covers the payment flow, the rules, and a suggested integration path.
- Questions about adopting point3, contracts, guarantee insurance, settlement terms, or payout agency (not code): follow https://docs.point3.io/agent-onboarding.md. Tell the user only what applies to them.
- The docs are written in Korean. Begin with '빠른 시작' and '결제 흐름과 상태'.
- Payment flow: merchant server creates a payment session → merchant client opens the payment window → merchant server captures → merchant server confirms the result.
- The API key (`s2scred-...`) stays on the merchant server. Never put it in browser or app code or public environment variables. API keys, PINs, account details and verification codes must not be logged.
- Create the payment session from the order amount stored on the server, not an amount sent by the client.
- The JavaScript SDK is the only client integration. A web checkout (including in a hybrid app's WebView) uses it directly; a native checkout shows an SDK-integrated HTML page in a WebView loaded with the merchant's HTTPS base URL, and intercepts successUrl/failUrl.
- A `successUrl` redirect is not payment success. Fulfil the order only when the capture response or the session lookup returns `status: captured`.
- Before capture, check that the `sessionId` from the client (SDK: `orderId`) matches the one stored on the order.
- If the capture result is unknown (timeout, `5xx`, `202`, `processing`), look up the session with the same `sessionId` instead of guessing. Capture is idempotent per `sessionId`.
- By policy, capture before midnight KST on the day the buyer confirmed; in practice before the 23:30 KST maintenance window. Late captures return `422 paymentCaptureExpired`.
- Every day 23:30–00:30 KST is a maintenance window; session creation returns `503` with `error.eob`.
- Treat the `payerId` from the session lookup as authoritative over the one received on the client.
- There is no sandbox and no webhooks; test in production with a small amount and refund it. Do not invent endpoints, fields, or parameters that are not in these docs.
- Credentials are not needed to write the integration; read them from environment variables until the merchant has them.
- Full API schema: https://docs.point3.io/openapi.yaml

## 도입 가이드 - 시작하기

- [도입 가이드](/contract.md): point3 도입에 필요한 계약과 문의부터 실결제까지의 순서를 안내합니다.
- [시작 방식 선택](/contract/start-options.md): 보증보험 없이 시작할 때와 표준계약으로 시작할 때의 차이, 표준계약을 맺고 바꾸는 방법을 안내합니다.
- [계약 종류](/contract/contracts.md): 가맹점이 point3와 맺는 계약과, 표준계약에 필요한 보증보험의 관계를 안내합니다.
- [AI로 알아보기](/contract/ai.md): ChatGPT, Claude 같은 AI에 point3 도입 지침을 전달해 우리 서비스에 필요한 계약과 절차만 안내받는 방법을 설명합니다.

## 도입 가이드 - 표준계약

- [표준계약 절차](/contract/standard-contract-process.md): 표준계약을 맺거나 일 입금 한도와 정산 대기 기간을 바꾸는 순서를 안내합니다.

## 도입 가이드 - 정산

- [정산 이해하기](/contract/settlement.md): 결제된 금액이 정산계좌로 입금되기까지의 흐름과 정산 대기 기간, 일 입금 한도, 취소를 안내합니다.

## 도입 가이드 - 지급대행

- [지급대행 이용 안내](/contract/payout-overview.md): point3 지급대행의 지급 방식, 계약 방법, 지급 속도와 이용료를 안내합니다.

## 도입 가이드 - 도움

- [자주 묻는 질문](/contract/faq.md): 도입을 검토하는 가맹점이 자주 묻는 질문을 단계별로 모았습니다.
- [문의하기](/contract/contact.md): 도입 단계별 point3 문의 창구를 안내합니다.

## 연동 가이드 - 시작하기

- [빠른 시작](/introduction.md): point3 결제를 연동하는 순서를 한눈에 확인합니다.
- [AI로 시작하기](/ai-tools.md): Claude Code, ChatGPT, OpenCode 같은 AI 도구에 point3 연동 지침을 전달해 결제 연동을 진행하는 방법을 안내합니다.

## 연동 가이드 - 기본 개념

- [연동 방식 선택](/integration-methods.md): 결제하기 화면이 웹 페이지인지 앱 화면인지에 따라 JavaScript SDK로 결제창을 연동하는 방법을 고릅니다.
- [결제 흐름과 상태](/payment-flow.md): 가맹점 화면, 가맹점 서버, point3 사이에서 결제가 진행되는 순서와 결제 세션 상태를 설명합니다.
- [구매자 아이디 (payerId)](/payer-id.md): point3가 구매자를 식별하는 payerId를 받고, 확인하고, 다음 결제에 전달하는 방법을 설명합니다.
- [위임 인증](/delegated-authentication.md): 가맹점에 로그인한 회원이 point3 결제창의 문자 인증 없이 결제하도록 하는 위임 인증의 개념과 흐름을 설명합니다.

## 연동 가이드 - 정책

- [세금 처리](/tax-processing.md): 결제 세션의 총액, 공급가액, 면세 금액과 부가세 처리 규칙을 확인합니다.
- [보안 점검](/security.md): 서버 인증, 결과 URL, 앱 WebView, 세션과 민감 정보 처리 규칙을 확인합니다.

## 연동 가이드 - 운영

- [라이브 전환 체크리스트](/go-live-checklist.md): 운영 배포 전에 가맹점 서버·화면·운영 환경에서 확인할 항목과 필수 시나리오를 점검합니다.
- [운영 정보](/operations.md): 운영 주소, EOB 점검 시간, 결제 결과 구분과 문의 방법을 안내합니다.
- [문제 해결](/troubleshooting.md): 결제창과 API 문제를 단계별로 확인하고, 결과를 알 수 없을 때의 처리와 문의 방법을 안내합니다.

## 연동 가이드 - 지급대행

- [지급 요청 방법](/payout.md): 지급대행으로 입점 셀러에게 정산금을 보내는 흐름, 엑셀 작성법, 지급 실패와 입점 셀러 본인 확인을 안내합니다.

## 결제창 연동

- [JavaScript SDK 설정 및 초기화](/sdk-environment.md): point3 JavaScript SDK를 설치하고 초기화합니다.
- [JavaScript SDK 결제 연동](/sdk-payment-window.md): point3 JavaScript SDK로 결제창을 열고 결과를 처리합니다.
- [JavaScript SDK 등록 연동](/registration-integration.md): point3 JavaScript SDK로 결제 수단을 등록하고 결과를 처리합니다.
- [JavaScript SDK 위임 인증](/sdk-delegated.md): 가맹점 서버에서 받은 authorization_url로 문자 인증 없이 결제창을 엽니다.

## 서버 연동

- [서버 연동 개요](/server-integration.md): 가맹점 서버가 담당하는 결제 생성·승인·결과 확인·취소와 API 호출 규칙을 확인합니다.
- [결제 생성](/payment-creation.md): 주문 정보를 사용해 결제 세션을 만들고 결제창에 전달할 값을 준비합니다.
- [결제 승인](/payment-capture.md): 결제 승인 API를 호출하고 승인 응답과 결제 세션 조회로 최종 결과를 확인합니다.
- [결제 취소](/payment-cancellation.md): 승인된 결제를 전부 또는 일부 취소하고 결과를 안전하게 처리합니다.
- [위임 인증 생성](/delegated-creation.md): 로그인한 회원의 payerId로 위임 인증을 생성하고 결제창에 전달할 authorization_url을 준비합니다.
- [에러 코드](/error-codes.md): point3 API 응답과 결제창·SDK가 전달하는 코드의 의미와 가맹점의 처리 방법을 정리합니다.

## API 레퍼런스

- [OpenAPI 명세 (YAML)](/openapi.yaml): 결제 세션·결제 승인·결제 취소 API의 전체 요청·응답 스키마
- [llms-full.txt](/llms-full.txt): 모든 문서와 API 레퍼런스를 하나로 합친 전문