개발자 문서

PayRi 연동은 퀵스타트부터 시작해 테스트 결제와 웹훅을 확인해요.

연동 계약 요약

항목	계약
자격증명	API 키 `pyr_live_…` 또는 `pyr_test_…`, 웹훅 시크릿 `whsec_…`예요. API 키는 서버에서만 사용하고, 웹훅 시크릿은 엔드포인트마다 관리해요.
Base URL	`https://api.payri.kr`예요. API 경로는 `/v1/…`로 시작해요.
인증	`Authorization: Bearer pyr_live_…` 형식으로 보내요.
mode	테스트는 `pyr_test_` 키로 만든 세션, 운영은 `pyr_live_` 키로 만든 세션을 사용해요.

대표 결제 흐름

복귀 주소만으로 결제를 확정하지 말고, order.paid 서명을 검증해 이벤트 id로 중복을 제거하거나 서버에서 Checkout Session·주문을 조회해 확인해요.

문서 바로가기

퀵스타트

Test 키로 결제 세션을 만들고 웹훅까지 확인해요.

test 모드

테스트 결제와 운영 데이터의 차이를 확인해요.

인증과 API 키

API 키 발급, 보관, 회전 규칙을 확인해요.

REST API

공통 규칙과 엔드포인트를 확인해요.

웹훅

이벤트, 서명 검증, 재시도를 설정해요.

라이선스 연동

키 발급 방식과 앱 API를 연결해요.

SDK

JavaScript·TypeScript에서 공식 SDK를 사용해요.

운영 전환 체크리스트

Live 키와 엔드포인트를 배포 전에 점검해요.

변경 이력

이번 계약 개편과 문서 정정 항목을 확인해요.

AI 코딩 도구로 연동하기

문서 사이트의 llms.txt는 목차, llms-full.txt는 전체 문서를 제공해요.
아래 프롬프트를 AI 코딩 도구에 붙여넣으면 llms-full.txt를 읽고 연동 코드를 작성해요.


https://docs.payri.kr/llms-full.txt 를 읽고 내 앱에 PayRi 결제를 연동해줘.
서버에서 Checkout Session을 만들어 결제창으로 보내고, 결제가 끝나면 successUrl로 돌아오게 해줘.
order.paid 웹훅은 서명을 검증해서 받아줘.
먼저 test 키로 테스트 결제부터 웹훅 수신까지 확인해줘.
API 키와 웹훅 시크릿은 환경변수 PAYRI_API_KEY, PAYRI_WEBHOOK_SECRET 에 있어.