신농 보이옥션 — KSNET 결제 연동 가이드 v2.29.0

✅ KSNET 계약 완료

🛡️ 구매안전서비스 등록번호 A03-170906-0035

신농 보이옥션 × KSNET 결제 연동 가이드

주식회사 아토미아 · 736-86-00383 · 대표 박동규 · KSNET 에스크로 자동갱신 중

✅ 에스크로 계약 완료

✅ 구매안전서비스 등록

✅ payment.js v3.1 준비

🔧 운영 MID 발급 요청

🔧 백엔드 서명 API 구현

⏳ 실결제 테스트

⏳ 라이브 오픈

📜 구매안전서비스 이용 확인증 (이미 발급 완료)

🛡️ 구매안전서비스 이용 확인증

상호주식회사 아토미아

소재지충청북도 청주시 상당구 중앙로 47 (북문로3가) 1층

대표자박동규

사업자등록번호736-86-00383

서비스 제공자(주)케이에스넷 (KSNET)

서비스 이용기간2017-07-21 ~ 서비스 해지시까지 (자동갱신 중)

서비스 등록번호A03-170906-0035

발급일2026년 07월 09일

확인처1544-6030 · www.ksnet.co.kr

✅ 전자상거래법 제13조 제2항 제10호 충족 ✅ 전자상거래법 제24조 제1항 충족 🔄 1년 자동갱신

🎉

법적 의무사항 완비 — 즉시 운영 가능한 에스크로 기반 구축 완료

전자상거래 소비자 보호에 관한 법률상 온라인 결제 사업자 필수 요건(결제대금 예치 + 소비자 피해보상 보험)이 이미 충족되어 있습니다. KSNET에서 운영 MID만 발급받으면 즉시 실결제가 가능합니다.

🚀 실결제 전환 — 단 2단계

📞 KSNET 운영 MID 발급 요청

전화: 1544-6030 (KSNET 고객센터)
"온라인 쇼핑몰 결제 MID 신규 발급 요청합니다. 기존 구매안전서비스 가맹점 아토미아입니다."

준비 서류: 사업자등록증 사본, 대표자 신분증 사본
처리 기간: 1~3 영업일 (기존 가맹점이므로 단축 가능)
수신 정보: MID (가맹점 ID) + 서명키 (signKey) → 이메일 수신

⌨️ js/payment.js 한 줄 교체 → 즉시 실결제

✅ MID(MA01)와 signKey는 이미 적용 완료되었습니다. 백엔드 /api/ksnet/sign 구현 후 아래 한 줄만 변경하세요.

// js/payment.js — KSNET_CONFIG (현재 적용된 상태)
const KSNET_CONFIG = {
  mid:        'MA01',                              // ✅ 상용 MID 적용됨
  signKey:    '0BBCD038798B2F5F6EE018C82B16F59F',  // ✅ 상용 signKey 적용됨
  merchantNo: '2865107193',                       // ✅ 가맹점 번호 적용됨

  /* ▼ 백엔드 구현 완료 후 false 로 변경할 한 줄 ▼ */
  testMode:   true,   // ←← 백엔드 /api/ksnet/sign 완료 후 false 로 변경

  // 이하 변경 불필요
  payUrl:   'https://pay.ksnet.co.kr/KSPayWeb/KSPayPWeb.jsp',
  escrowYn: 'Y',
  bizNo:    '7368600383',
  safeReg:  'A03-170906-0035',
};
        

✅

MID · signKey 적용 완료

2026-07-10 발급된 운영 키(MID=MA01, signKey=0BBCD038…)가 이미 적용되어 있습니다. 남은 작업은 백엔드 /api/ksnet/sign 구현 후 testMode: false로 변경하는 것뿰입니다.

⚠️

추가 필수: 백엔드 서명 API 구현

KSNET은 보안상 서버에서 SHA256 HMAC 서명 후 폼을 POST하는 방식입니다. /api/ksnet/sign 엔드포인트를 서버(Node.js/Python 등)에 구현해야 합니다. 아래 섹션에서 구체적인 구현 방법을 확인하세요.

🔧 백엔드 서버 API 구현 가이드

필요한 서버 API 3개

POST /api/ksnet/sign

KSNET 결제 파라미터 서명 생성 (SHA256 HMAC) → signData 반환

POST /api/payment/ksnet/confirm

KSNET 결제 완료 후 서버 검증 (금액 위변조 방지)

POST /api/ksnet/webhook

KSNET 결제 상태 변경 웹훅 수신 (에스크로 상태 업데이트)

Node.js 구현 예시

// /api/ksnet/sign  (Express.js 예시)
const crypto = require('crypto');

app.post('/api/ksnet/sign', (req, res) => {
  const { mid, orderId, amount, goodsName } = req.body;
  const signKey = process.env.KSNET_SIGN_KEY; // 환경변수로 관리!

  // KSNET 서명 생성: mid + orderId + amount + signKey
  const signStr = mid + orderId + amount + signKey;
  const signData = crypto
    .createHash('sha256')
    .update(signStr)
    .digest('hex');

  res.json({ signData, ordrIdxx: orderId });
});

// /api/payment/ksnet/confirm  (결제 검증)
app.post('/api/payment/ksnet/confirm', async (req, res) => {
  const { orderId, authNo, resCd } = req.body;
  // KSNET API로 결제 검증 후 DB 저장
  // resCd === '00' → 결제 성공
  res.json({ ok: resCd === '00' });
});
    

🔐

보안 주의사항

KSNET signKey는 절대 프론트엔드(js/payment.js)에 직접 입력하지 마세요. 반드시 서버 환경변수(process.env.KSNET_SIGN_KEY)로 관리하고 서버에서만 서명하세요.

💳 KSNET 지원 결제 수단

결제 수단	방식	에스크로	수수료율 (참고)	준비 상태
💳 신용·체크카드	KSNET 카드 결제창	✅ 적용	약 2.0~3.5%	즉시 가능 (MID만)
🏦 실시간 계좌이체	KSNET 뱅킹 모듈	✅ 적용	약 0.5~1.5%	즉시 가능 (MID만)
📄 가상계좌 (무통장)	자체 계좌 처리	✅ 적용	건당 200~400원	현재 사용 중
⚡ 카카오페이	KSNET 통합 간편결제	✅ 적용	약 2.0~2.5%	즉시 가능 (MID만)
⚡ 네이버페이	KSNET 통합 간편결제	✅ 적용	약 2.0~2.5%	즉시 가능 (MID만)
💙 삼성페이	KSNET 통합 간편결제	✅ 적용	약 2.0~2.5%	즉시 가능 (MID만)
📱 휴대폰 소액결제	KSNET 휴대폰 모듈	—	약 5.0~8.0%	MID 발급 후 별도 신청

* 수수료율은 가맹점 계약 조건에 따라 다를 수 있습니다. KSNET 담당자에게 문의하세요.

🛡️ KSNET 에스크로 안전결제 플로우

낙찰·입찰

→

구매자 결제

→

KSNET 에스크로 보관

→

판매자 발송

→

배송 완료

→

구매자 확정

→

판매자 정산

상태	아이콘	설명	구매자 액션	판매자 액션
결제대기	⏳	주문 생성, 미결제 상태	결제 진행	대기
결제완료	💙	KSNET 에스크로 보관 시작	상품 수령 대기	상품 발송
배송중	🚚	판매자 발송 처리 완료	수령 확인	대기
배송완료	📦	택배 배달 완료	구매확정 or 환불	대기
구매확정	✅	KSNET → 판매자 대금 지급	완료	정산 수령
분쟁접수	⚠️	관리자+KSNET 조정 개입	증빙 제출	증빙 제출
환불완료	↩️	KSNET 에스크로에서 구매자 환불	환불 수령	상품 반품

💡

KSNET 에스크로 자동 확정: 배송완료 후 7일 이내 구매확정이 없으면 자동 확정 처리됩니다. 에스크로 보호 기간 내에는 구매자가 언제든 환불 요청 또는 분쟁 신청이 가능합니다.

⚖️ 법적 요건 체크리스트

🏢 사업자 요건

사업자등록 완료 — 주식회사 아토미아 (736-86-00383)

통신판매업 신고 완료 (전자상거래법 제12조)

구매안전서비스 가입 — KSNET (A03-170906-0035) ← 이번에 확인!

개인정보처리방침 사이트 공지 (개인정보보호법 제30조)

이용약관 사이트 공지

청약철회 정책 고지 (7일 이내, 전자상거래법 제17조)

💳 KSNET 결제 연동

KSNET 구매안전서비스 계약 완료 (2017~ 자동갱신)

payment.js v3.1 KSNET 프론트엔드 코드 준비 완료

KSNET 운영 MID 발급 (1544-6030 문의)

KSNET_CONFIG.mid / signKey 교체 완료

백엔드 /api/ksnet/sign 서명 API 구현

백엔드 /api/payment/ksnet/confirm 검증 API 구현

KSNET 결제 테스트 (testMode: true 모달 동작 확인) 완료

운영 MID로 실결제 최종 검증

🔒 보안 요건

HTTPS 적용 (SSL 인증서) — KSNET 필수 요건

KSNET signKey 환경변수 관리 (코드 직접 노출 금지)

서버에서 결제 금액 위변조 검증

개인정보(카드번호 등) 서버 미저장 확인

📅 실행 타임라인 (최단 경로)

✅ Phase 0 — 완료 (현재)

완료됨

KSNET 구매안전서비스 계약 (A03-170906-0035)
payment.js v3.1 KSNET 전용 코드 완성
에스크로 상태머신, 결제 모달, 영수증, 분쟁 모달 전체 구현

🔧 Phase 1 — 지금 당장 (1~3영업일)

즉시 시작 가능

📞 1544-6030 전화 → "온라인 결제 MID 발급 요청"
준비물: 사업자등록증, 대표자 신분증
→ 이메일로 MID + 서명키 수신
→ js/payment.js 2줄 교체

⚙️ Phase 2 — 백엔드 구현 (1~2주)

Phase 1 완료 후

Node.js/Python 서버 구축
/api/ksnet/sign — KSNET SHA256 서명 API
/api/payment/ksnet/confirm — 결제 검증 API
/api/ksnet/webhook — 에스크로 상태 변경 수신

🧪 Phase 3 — 테스트 결제 검증 (3~5일)

Phase 2 완료 후

KSNET 테스트 MID(IPAYtest)로 전 결제수단 검증
카드/계좌이체/가상계좌/카카오페이/네이버페이
에스크로 구매확정→판매자 정산 플로우 검증

🚀 Phase 4 — 라이브 오픈

Phase 3 완료 후

운영 MID로 교체 → 실결제 최종 확인 (소액 1건)
마이페이지 주문내역 · 에스크로 상태 · 정산내역 확인
KSNET 가맹점 관리자 페이지에서 결제 내역 확인

💰 KSNET 결제 비용 구조

항목	내용	비용
KSNET 구매안전서비스	이미 계약 완료 (자동갱신)	✅ 포함
KSNET 카드 결제 수수료	낙찰가 × PG 수수료율 (가맹점 협의)	약 1.8~3.5%
KSNET 계좌이체 수수료	건당 또는 금액 기준	약 0.5~1.5%
KSNET 가상계좌 수수료	건당 고정 요금	약 200~500원/건
KSNET 간편결제 수수료	카카오·네이버·삼성페이	약 2.0~2.5%
서버 호스팅 (API 서버)	AWS/Vercel/Railway 등	월 2~10만원
SSL 인증서	Let's Encrypt (무료) 또는 유료	무료~연 10만원
초기 구축 비용 합계 (개발 인건비 제외)		약 2~10만원/월

* KSNET PG 수수료는 월 매출 규모·카드사별로 상이합니다. 가맹점 계약 시 담당자와 협의하세요.

📞 KSNET 연락처 및 참고 자료

📞

고객센터

1544-6030
평일 09:00~18:00
토·일·공휴일 휴무

🌐

공식 홈페이지

www.ksnet.co.kr
가맹점 조회 · API 문서
사업자번호로 가입 확인

📋

가맹점 조회

사업자번호: 736-86-00383
KSNET 홈페이지 → 가맹점 조회 메뉴에서
가입 사실 및 에스크로 상태 확인 가능

🔑

MID 발급 요청 시

"온라인 쇼핑몰 신규 결제 MID 발급"
"기존 구매안전서비스 가맹점"
"에스크로 결제 포함 요청"

🛡️ KSNET 에스크로 안전결제 준비 완료

신농 보이옥션 × 주식회사 아토미아 · 사업자번호 736-86-00383
구매안전서비스 등록번호 A03-170906-0035 · 서비스 이용 확인: 1544-6030
최종 업데이트: 2026-07-10 v2.29.0