통합 결제 API
HTTP + JSON으로 주문 생성, 상태 조회, 환불을 처리합니다.
글로벌 비즈니스를 위한 결제 인프라
해외 결제를더 명확하고 안정적으로.
주문 생성부터 자금 정산까지, 결제·환불·알림·출금을 하나의 서버 API로 관리하세요. 팀은 비즈니스에 집중할 수 있습니다.
- 무료 테스트 환경
- 호스팅 결제
- 검증 가능한 Webhook
주문 금액
$29.90 USD
ORD_2026_001
테스트 환경결제 완료
결제 라이프사이클
- 주문 생성
POST /v1/orders - 결제 화면 진입
checkout_url - 결제 성공
payment.succeeded - Webhook 전송 완료
HTTP 200 - 원장에 기록
+ $29.90
- 통합 API
- HTTP + JSON
- 기존 서버에 쉽게 연동
- 테스트와 운영 분리
- 2개 환경
- 키 접두사로 구분
- 서명된 알림
- HMAC-SHA256
- 신뢰할 수 있는 비동기 이벤트
- 미결 거래
- 자동 대사
- 최종 상태 재확인
플랫폼 기능
결제 흐름에 필요한 모든 것
하나의 API에서 상태를 조회하고 자금 이동을 추적할 수 있습니다.
호스팅 결제
서명된 링크로 이동하므로 결제 정보를 직접 처리할 필요가 없습니다.
환경 분리
테스트와 운영에 별도 키를 사용해 실거래 오류 위험을 줄입니다.
안정적인 Webhook
서명 검증, 실패 시 재전송, 전송 기록, 수동 재전송을 지원합니다.
자동 대사
알림 누락 시 미결 결제와 환불 상태를 다시 확인합니다.
지갑과 원장
입금, 환불, 출금에 따른 잔액 변화를 추적합니다.
요청
curl -X POST https://api.kukopay.com/v1/orders \
-H "X-Api-Key: kuko_test_•••" \
-H "Content-Type: application/json" \
-d '{
"out_trade_no": "ORD_2026_001",
"amount": 2990,
"currency": "USD",
"subject": "Premium plan"
}'응답 201
{
"code": 201,
"data": {
"trade_no": "TRD_SB_9F3A2C7E…",
"status": "pending",
"checkout_url": "https://checkout.kukopay.com/…"
}
}연동 과정
4단계로 결제 완료
브라우저 복귀는 사용자 경험을 위한 것이며, 상품 제공은 서명 검증된 서버 알림을 기준으로 합니다.
- 1
테스트 키 발급
가맹점 등록 후 테스트 키를 신청합니다.
- 2
주문 생성
금액, 주문 번호, 알림 URL을 보내 결제 링크를 받습니다.
- 3
구매자 결제
구매자를 KukoPay 호스팅 결제 화면으로 이동시킵니다.
- 4
검증 후 제공
payment.succeeded를 검증하고 이벤트 ID로 중복 처리합니다.
보안 설계
안전 장치를 흐름에 내장
환경 분리, 서명 검증, 원장 규칙으로 운영 실수를 줄입니다.
키 보호
키는 암호화해 보관하며 가맹점이 재발급할 수 있습니다.
접근 제어
가맹점별 API 제한과 선택적 IP 허용 목록.
환경 분리
테스트와 운영은 독립된 키와 원장을 사용합니다.
자금 일관성
잔액 변경과 멱등 상태 전환을 기록합니다.
자주 묻는 질문
연동 전에 알아둘 내용
API 문서는 어디에 있나요?
공개 문서는 kukopay.com/docs에 있으며, 키·주문·Webhook 전송 기록은 가맹점 포털에서 확인할 수 있습니다.
중복 주문과 중복 제공은 어떻게 막나요?
주문 생성 시 고유한 out_trade_no를 사용하고 Webhook은 이벤트 ID로 중복 제거하세요. 시간 초과 후 같은 주문 번호로 재시도할 수 있습니다.
브라우저 복귀로 결제 완료를 판단할 수 있나요?
아니요. payment.succeeded Webhook의 서명을 검증한 뒤 제공하고, 필요하면 주문 조회로 추가 확인하세요.
첫 테스트 주문을 만들어 보세요
가맹점 계정을 열고 테스트 키를 발급받아 빠른 시작 문서를 따라 연동하세요.