카페24 연동
카페24 쇼핑몰을 연결하면 무통장입금 주문이 페이싱크 주문으로 만들어지고, 입금이 확인되면 카페24 주문이 입금 확인 상태로 바뀌어요.
카페24 쇼핑몰을 연결하면 코드를 쓰지 않고 무통장입금 확인을 자동으로 처리할 수 있어요.
연결 방법
먼저 카페24 쇼핑몰의 무통장입금 계좌를 페이싱크 계좌에도 연결하고 1원 인증까지 마쳐요. 카페24 주문의 입금 계좌번호와 같은 계좌가 있어야 주문을 가져와요.
쇼핑몰은 두 가지 방법으로 연결해요. 쇼핑몰을 연결하려면 소유자나 개발자 역할이 필요해요.
페이싱크 대시보드에서 연결하기
대시보드 쇼핑몰에서 쇼핑몰 아이디로 연결을 누르고 카페24 쇼핑몰 아이디를 입력해요. 쇼핑몰 아이디는 카페24 관리자 주소 myshop.cafe24.com의 앞부분이에요. 카페24 화면에서 페이싱크 앱 권한을 승인하면 연결이 끝나요.
카페24에서 앱을 설치해 연결하기
카페24 앱스토어나 관리자에서 페이싱크 앱을 실행하면 페이싱크로 이동해요. 연결할 워크스페이스를 고르면 연결이 끝나요.
쇼핑몰 하나는 워크스페이스 하나에만 연결할 수 있어요. 연결할 수 있는 쇼핑몰 수는 무료와 스타터 요금제에서 1개, 프리미엄 요금제에서 3개예요. 요금제를 내리면 한도를 넘는 쇼핑몰은 최근에 연결한 것부터 연동이 해제돼요.
동작 방식
| 카페24에서 일어난 일 | 페이싱크가 하는 일 |
|---|---|
| 무통장입금 주문 생성 | 주문자 이름과 결제 금액으로 페이싱크 주문을 만들어요. 받을 계좌는 카페24 주문의 입금 계좌로 지정하고, 입금 기한은 7일이에요. |
| 고객이 입금 | 입금이 매칭되면 카페24 주문을 입금 확인 상태로 바꿔요. |
| 입금 기한 7일이 지남 | 페이싱크 주문이 만료되고, 카페24 주문도 취소해요. |
| 입금 전 주문 취소 | 페이싱크 주문을 취소해요. |
주문자 이름의 띄어쓰기는 빼고 입금자명으로 써요. 16자를 넘으면 은행이 이름을 잘라 보내니 이름 앞자리 매칭을 켜 두세요.
카페24 주문으로 만든 페이싱크 주문도 일반 주문과 같아서 invoice.created, invoice.paid, invoice.expired 웹훅이 가요. 입금 전 취소로 페이싱크 주문이 취소되면 invoice.canceled 웹훅이 가요. v1 웹훅에는 invoice.deleted로 가요.
주문의 source는 CAFE24이고, cafe24에 쇼핑몰 아이디, 상점 번호, 카페24 주문번호가 담겨요. metadata에는 CAFE24_INTEGRATION, CAFE24_MALL_ID, CAFE24_SHOP_NO, CAFE24_ORDER_ID가 들어가요. API로 주문을 만들 때는 CAFE24_로 시작하는 키를 쓰지 마세요.
쇼핑몰 설정
대시보드 쇼핑몰에서 쇼핑몰마다 설정을 바꿔요. 새로 연결한 쇼핑몰은 세 기능이 모두 켜져 있어요.
| 설정 | 하는 일 |
|---|---|
| 새 주문 자동 가져오기 | 무통장입금 주문 중 연결한 계좌로 받는 주문만 가져와요. 입금 기한은 7일이에요. |
| 입금 확인 시 카페24 주문을 결제 완료로 변경 | 매칭된 입금이 생기면 카페24 주문 상태를 입금 확인으로 바꿔요. |
| 입금 기한이 지나면 카페24 주문 취소 | 기한 안에 입금이 없어 만료된 주문을 카페24에서도 취소해요. |
설정을 다시 켜도 꺼져 있던 동안의 주문은 소급해서 처리하지 않아요. 새 주문 자동 가져오기나 결제 완료로 변경을 끄면 소유자에게 메일로 알려요.
같은 주문이 이미 있을 때
입금자명, 금액, 입금 계좌가 모두 같은 결제 대기 주문이 있으면 입금이 어느 주문 것인지 알 수 없어서 새 주문을 그대로 만들 수 없어요. 이때 어떻게 할지 골라요.
| 처리 방식 | 하는 일 |
|---|---|
| 페이싱크에 만들지 않기 (기본값) | 카페24 주문은 그대로 두고, 먼저 들어온 주문만 입금을 기다려요. |
| 입금자명을 바꿔서 만들기 | 박지훈 → 박지훈2처럼 뒤에 숫자를 붙여 만들고, 바꾼 이름을 카페24 주문 메모에 남겨요. 구매자가 바뀐 이름으로 입금해야 매칭돼요. |
| 카페24 주문 취소하기 | 카페24에서 새 주문을 취소해요. 구매자가 입금자명을 바꿔 다시 주문해야 해요. |
멤버에게 이메일을 켜면 이메일 알림에서 같은 주문 감지를 켠 멤버가 메일을 받아요. 구매자에게 이메일을 켜면 고른 처리 방식에 맞춰 구매자에게 안내 메일을 보내요. 주문에 구매자 이메일이 있을 때만 보내요.
동기화 기록
대시보드 쇼핑몰의 동기화 기록에서 주문을 가져오고 카페24에 반영한 결과를 볼 수 있어요. 카페24 응답이 늦거나 일시적으로 실패한 반영은 다시 시도할 수 있어요. 동기화 기록은 360일 동안 남아요.
카페24 로그인이 만료됐을 때
카페24 접근 권한이 만료되면 대시보드 쇼핑몰에 “카페24를 다시 연결해 주세요” 안내가 나와요. 이 동안에도 새 주문은 가져오지만, 결제 완료와 취소를 카페24에 반영하지 못해요. 대시보드 쇼핑몰에서 같은 쇼핑몰을 다시 연결하면 설정은 그대로 두고 권한만 새로 받아요. 실패했던 반영은 다시 연결한 뒤 다시 시도할 수 있어요.
주문이 만들어지지 않을 때
- 카페24 주문의 입금 계좌번호가 페이싱크에 연결하고 1원 인증을 마친 계좌와 같은지 확인하세요.
- 쇼핑몰 설정에서 새 주문 자동 가져오기가 켜져 있는지 확인하세요.
- 같은 입금자명과 금액으로 결제 대기 중인 주문이 이미 있으면 같은 주문이 이미 있을 때 설정을 따라요. 주문 충돌 규칙도 참고하세요.
- 무통장입금이 아닌 결제 수단의 주문은 가져오지 않아요.
- 은행이 긴 입금자명을 잘라서 보낸다면 이름 앞자리 매칭을 켜 보세요.
- 연결이 오래 걸리거나 실패하면 대시보드에서 다시 시도하거나 카페24에서 앱을 다시 실행해요. 해결되지 않으면 상담 위젯으로 문의하세요.