개발자

공개 SDK로 시작하고,
승인 후 실제 결제를 엽니다.

Node.js·Python SDK와 OpenAPI 규격은 지금 확인할 수 있습니다. 테스트·운영 자격정보는 가맹·CAT·STORE 확인 후 발급합니다.

SDK 받기 API Reference

결제 요청결과 확인결제 취소

공개 SDK · API 규격

결제 생성·조회·취소를
한 클라이언트로 연결합니다.

SDK와 OpenAPI는 지금 바로 내려받아 연동 코드를 만들 수 있습니다. 실제 테스트·운영 호출 자격정보는 사업자·가맹·CAT·STORE 확인 후 발급합니다.

GitHub에서 받기 OpenAPI YAML

Node.js · TypeScript

Node 18+ · 외부 런타임 의존성 0개 · 타입 포함

npm install github:GOATHEAVEN-Inc/cari-pay-sdk

Python

Python 3.9+ · 표준 라이브러리 기반

pip install git+https://github.com/GOATHEAVEN-Inc/cari-pay-sdk.git#subdirectory=python

OpenAPI 3.0

Java·PHP·Go 등 원하는 언어 클라이언트 생성

openapi-generator -i openapi.yaml -g <language>

server/payments.mjsSERVER ONLY

import { CariPay } from '@caripay/sdk';

const pay = CariPay.fromEnv();
const { redirectUrl, transSeqno } = await pay.createPayment({
  amount: 128000,
  mobileNo: '01012345678',
  payerName: '홍길동',
  reason: '8월 이용료',
  confirmUrl: 'https://api.example.com/caripay/callback',
});

API Key와 금액 결정은 브라우저·앱이 아니라 서버에 둡니다.

SAFE PAYMENT FLOW

화면 이동보다 거래 조회를 믿습니다.

파트너 서버

주문 금액 확정 · SDK 호출 · 주문/거래번호 저장

CARI PAY

결제링크 발급 · 상태 조회 · 취소 요청 연결

파트너 Callback

거래 재조회 · 중복 차단 · 서비스 제공

Callback 본문을 그대로 승인으로 처리하지 않고 조회 API로 금액과 상태를 다시 확인합니다.

사업자등록 전 개인 개발자도 시작할 수 있습니다.

SDK·OpenAPI로 결제 모듈을 먼저 구현하고, 실제 결제를 받을 사업자와 정산 명의가 정해지면 가맹·CAT·STORE 심사를 이어가세요.

API 전체 규격 내 연동 방식 찾기

결제를 붙이고 싶다면, CARI PAY SDK에서 시작하세요.

코드를 먼저 구현하거나 가맹·CAT·STORE 개통부터 진행할 수 있습니다.

연동 도입 시작하기

공개 SDK로 시작하고,승인 후 실제 결제를 엽니다.