자료 정보
| 쉬운 설치 | 쉬운 설치 지원 |
|---|---|
| 간단한 소개 | 커머스·예약이 함께 쓰는 공용 결제 모듈. 토스페이먼츠·KG이니시스·NHN KCP·나이스페이·포트원·페이팔·Conekta·무통장입금을 관리 화면에서 켜고 키만 넣으면 됩니다. 부분 취소·환불, 웹훅, 다통화 지원. 라이믹스 2.1 호환(베타). |
| 설치 경로 | ./modules/zittme_pay |
| PHP 지원 범위 | PHP 7.4 이상 |
| 자료 구분 | 공개 자료 GPL v2 |
| 저장소 URL | https://github.com/zittme/zittme_pay |
| 데모 URL | https://kfashion-demo.zitt.me/ |
| 원본 URL | https://zitt.me/store/package/30747 |
| AI 사용 여부 | AI로 생성한 코드가 포함되어 있고, 전문 개발자의 검토를 거쳤습니다. |
버전 내역
상세 설명
ZITTME PAY
결제는 짓미페이가 맡습니다
커머스, 예약, 그 밖에 돈을 받는 모든 곳이 같은 결제 흐름을 씁니다. 결제사는 관리 화면에서 켜고 발급받은 키만 넣으면 됩니다. 주문번호가 결제 기록에 그대로 이어지고, 취소 · 환불 · 입금 확인까지 한자리에서 처리합니다.
국내 PG 5곳 해외 결제 무통장입금 부분 취소 다통화 라이믹스 2.1 호환
사용하던 결제사를 그대로 붙입니다
계약은 결제사와 직접 하시고, 발급받은 키를 관리 화면에 넣으면 됩니다. 키가 채워지지 않은 결제수단은 결제 화면에 나타나지 않습니다.
| 토스페이먼츠카드, 계좌이체, 가상계좌 | KG이니시스INIStdPay, 망취소, INIAPI 취소 | NHN KCP카드와 간편결제, 개인키 서명 취소 | 나이스페이가상계좌 입금 통지까지 처리 |
| 포트원 V2채널 하나로 여러 결제사 연결 | 페이팔해외 구매자에게 외화로 결제 | Conekta멕시코 카드, OXXO 현금, SPEI 계좌이체 | 무통장입금별도 계약 없이 계좌로 받고 확인 처리 |
켜고, 키를 넣으면 끝입니다
쓸 결제수단을 고르고 발급받은 키를 넣습니다. 웹훅 주소는 화면에 그대로 나오니 결제사 상점관리자에 복사해 넣기만 하면 됩니다.
- 테스트 키와 운영 키를 구분해 넣습니다
- 여러 결제수단을 동시에 켤 수 있습니다
- 결제 화면 스킨을 테마에 맞춰 고릅니다
- 추가 통화를 쓰면 환율 행이 자동으로 생깁니다 (하루 1회 자동 갱신)
결제 뒤에 오는 일들까지
결제는 승인으로 끝나지 않습니다. 취소와 환불, 입금 확인과 대사까지가 한 묶음입니다.
| 부분 취소와 환불주문의 일부만 취소하고 그만큼만 돌려줍니다. 결제사에 취소 요청을 보내고 결과를 기록합니다. | 무통장 입금 확인입금자명과 금액을 보고 관리 화면에서 확인 처리합니다. 확인하면 주문 상태가 함께 넘어갑니다. | 웹훅가상계좌 입금처럼 나중에 오는 통지를 받아 처리합니다. 사이트를 열어 두지 않아도 반영됩니다. |
| 통신 로그결제사와 주고받은 요청과 응답이 남습니다. 문제가 생겼을 때 어디서 어긋났는지 확인할 수 있습니다. | 다통화결제 통화를 여러 개 두고 환율을 관리합니다. 주문에는 결제 시점의 환율이 저장됩니다. | 주문번호 연동커머스와 예약의 주문번호가 결제 기록에 그대로 실립니다. 두 화면을 오가며 맞춰 볼 필요가 없습니다. |
보안 원칙
- 승인 금액은 항상 서버가 보관한 주문 금액을 기준으로 합니다. 브라우저가 보낸 금액은 대조용으로만 씁니다.
- 웹훅 본문을 믿지 않습니다. 결제사 조회 API 로 재확인한 결과만 반영합니다.
- 결제사가 확인해 준 금액이 주문 금액과 다르면 승인하지 않습니다.
라이믹스와 Zittme 호환
짓미페이는 Zittme 엔진용으로 만들어졌고, 0.2.8 부터 라이믹스 2.1 에서도 설치되도록 호환층(compat.php)을 함께 넣었습니다. 코드는 한 벌이라 두 엔진에서 같은 파일을 씁니다. 라이믹스에서 되는 것과 안 되는 것은 다음과 같습니다.
| 기능 | 라이믹스 2.1 | Zittme |
|---|---|---|
| 결제사 8종 (토스 · 이니시스 · KCP · 나이스페이 · 포트원 · 페이팔 · Conekta · 무통장) | 사용 가능 | 사용 가능 |
| 부분 취소 · 환불, 무통장 입금 확인, 웹훅, 통신 로그 | 사용 가능 | 사용 가능 |
| 다통화 · 환율 관리(수동 입력, 하루 1회 자동 갱신) | 사용 가능 | 사용 가능 |
| 커머스 · 예약 모듈 연동(주문번호 연동, 승인 · 취소 트리거) | 사용 가능 | 사용 가능 |
| 결제 · 결과 화면 기본 스킨 | 사용 가능 | 사용 가능 |
| 테마에 포함된 결제 화면 스킨(신선한 · 헤리티지 등 Zittme 테마) | 해당 없음 | 사용 가능 |
| 결제 화면을 사이트맵 · 검색엔진에서 자동 제외 | 해당 없음 | 1.1 부터 |
| 설치 · 업데이트 | 쉬운 설치 지원 | 스토어 알림 · 원클릭 업데이트 |
- 라이믹스에서는 Zittme 프레임워크 클래스 호출을 호환층이 라이믹스 클래스로 연결합니다. Zittme 코어에서만 있는 기능은 다른 코어에서 자동으로 건너뜁니다.
- 데이터 구조는 두 엔진이 같습니다. 나중에 Zittme 로 옮길 때 주문 · 결제 기록을 그대로 가져갈 수 있습니다.
라이믹스 호환 기능은 베타 단계라 환경에 따라 일부 불안정한 부분이 있을 수 있습니다. 설치나 결제 과정에서 문제가 보이면 꼭 버그 · 건의 제안에 제보해 주세요. 라이믹스 · PHP 버전과 결제사, 오류 문구를 함께 적어 주시면 빠르게 고쳐서 다음 판에 반영합니다.
라이믹스 2.1 이상 또는 Zittme 1.0.0 이상, PHP 7.4 이상. 다른 부가 모듈에 의존하지 않습니다.
라이믹스 쉬운 설치로 설치하거나, 압축을 풀어 modules/zittme_pay 에 놓습니다. 폴더 이름은 zittme_pay(밑줄)입니다. 이후 관리자 화면에 들어가면 테이블 생성과 기본 설정이 자동으로 진행됩니다. 업데이트 후에는 설치된 모듈 목록에서 모듈 업데이트를 한 번 실행해 주세요.
쇼핑몰이 필요하면 커머스 모듈과 함께 쓰세요. 커머스와 예약 모듈이 짓미페이를 공용 결제 계층으로 씁니다.
| 소개 페이지 | GitHub | 사용자 가이드 | 버그 · 건의 제안 |
GPL v2 · ZZAN Studio · zitt.me
사용자 피드백 2
현재 모듈 업데이트(설정 완료하기)가 진행되었음에도 불구하고 남아있는 현상이 있어 핫픽스 배포 예정입니다.
대박입니다. ^^*
잘 사용하겠습니다.