CARI PAY

준비하기

연동 정보 발급

결제 링크 연동에 필요한 3가지 코드와 청구서 연동에 필요한 가맹점 계정을 발급받는 절차입니다.

결제 링크 API — 4가지 값

도입 신청 후 가맹 심사가 끝나면 테스트·운영 각각 발급합니다.

항목예시보관
BASE_URLhttps://dev-api.chewingpay.com / https://api.chewingpay.com환경변수
PLATFORM_CODEPC**************** (20자)환경변수
STORE_CODESD**************** (20자)환경변수
API_KEY서명 시크릿환경변수·시크릿 매니저에만. 코드·로그·클라이언트 배포 금지
Shell
export CARIPAY_MODE=test            # 운영 전환 시 live
export CARIPAY_PLATFORM_CODE=PC...
export CARIPAY_STORE_CODE=SD...
export CARIPAY_API_KEY=...
  • 이미 카리페이 가맹점을 보유한 관계사가 있으면 그 STORE_CODE를 재사용해 바로 시작할 수 있습니다(결제대금은 그 가맹점 계좌로 정산). 정산을 분리하려면 전용 가맹점을 등록합니다.
  • 키 유출이 의심되면 즉시 재발급을 요청하세요. 재발급 시 이전 키는 폐기됩니다.

준비할 서류

항목비고
사업자등록증 사본법인·개인 모두 가능
대표자 성명·연락처·이메일가맹 심사·정산 통지용
업태·종목, 판매 상품 설명제한 업종 확인
정산 입금 계좌결제대금 입금 계좌
서비스 URL결제가 발생할 웹·앱 주소

표준 소요 기간은 서류 완비 기준 영업일 2~5일입니다.

청구서 API·콘솔 — 가맹점 계정

청구서 API는 API_KEY가 아니라 가맹점 계정의 접근 토큰으로 인증합니다.

  1. 가맹점 콘솔에서 회원가입(이메일·휴대폰 인증)합니다.
  2. 사업자 등록 서류를 제출하면 카리페이가 심사 후 승인합니다. 승인 전에는 청구서 발송이 잠깁니다.
  3. 발송 포인트를 충전합니다.
  4. 서버 연동은 로그인 API로 토큰을 발급받습니다.
HTTP
POST https://api.dev.caripay.co.kr/app/v1/auth/login
Content-Type: application/json

{ "email": "billing@example.com", "password": "********", "loginType": "EMAIL" }
JSON
{ "result_code": 0, "result_msg": "성공",
  "result_data": { "accessToken": "eyJ...", "refreshToken": "eyJ...", "accessTokenExpiresIn": 3600 } }
항목값
요청 헤더x-access-token: {accessToken}
접근 토큰 유효기간1시간
갱신POST /app/v1/auth/refresh { "refreshToken": "..." } → 새 토큰 쌍. 리프레시 토큰 유효기간 30일
만료 응답result_code: -2 (토큰 만료), -1 (토큰 없음)

문서에 없는 내용이나 오류는 bellight@goatheaven.com 또는 지원 문의로 알려주세요.