---
title: 카페24 연동
description: 카페24 쇼핑몰을 연동하면 무통장입금 주문이 페이싱크 주문으로 만들어지고, 입금이 확인되면 카페24 주문이 입금 확인 상태로 바뀌어요.
sidebar:
  order: 4
  icon: store
---

카페24 쇼핑몰을 연동하면 코드를 쓰지 않고 무통장입금 확인을 자동으로 처리할 수 있어요.

## 연동 방법

1. 카페24 쇼핑몰의 무통장입금 계좌를 페이싱크 **계좌 관리**에도 등록하고 1원 인증까지 마쳐요. 계좌번호가 같아야 주문이 연결돼요.
2. 대시보드 **쇼핑몰 연동** 메뉴에서 카페24 상점 아이디를 입력하고 **연동하기**를 눌러요.
3. 카페24 화면에서 페이싱크 앱 권한을 승인하면 연동이 끝나요.

연동할 수 있는 쇼핑몰 수는 무료와 스타터 요금제에서 1개, 프리미엄 요금제에서 3개예요.

## 동작 방식

| 카페24에서 일어난 일 | 페이싱크가 하는 일 |
| --- | --- |
| 무통장입금 주문 생성 | 주문자의 입금자명과 결제 금액으로 페이싱크 주문을 만들어요. 받을 계좌는 카페24 주문의 입금 계좌로 지정하고, 7일 뒤 만료되게 설정해요. |
| 고객이 입금 | 입금이 매칭되면 카페24 주문을 입금 확인 상태로 바꿔요. |
| 입금 전 주문 취소 | 페이싱크 주문을 지워요. |

카페24 주문으로 만들어진 페이싱크 주문도 일반 주문과 같아서 [`invoice.created`](/api-reference/webhooks/invoice-created), [`invoice.paid`](/api-reference/webhooks/invoice-paid) 웹훅이 가요. 입금 전 취소로 지워질 때는 `invoice.deleted` 웹훅이 가지 않아요.

주문의 `metadata`에는 `CAFE24_INTEGRATION`, `CAFE24_MALL_ID`, `CAFE24_SHOP_NO`, `CAFE24_ORDER_ID`가 들어가요. API로 주문을 만들 때는 `CAFE24_`로 시작하는 키를 쓰지 마세요.

## 주문이 만들어지지 않을 때

- 카페24 주문의 입금 계좌번호가 페이싱크에 등록한 계좌와 같은지 확인하세요.
- 같은 입금자명과 금액으로 결제 대기 중인 주문이 이미 있으면 새 주문을 만들지 않아요. [주문 충돌 규칙](/multi-bank-account-routing#주문-충돌-규칙)을 참고하세요.
- 은행이 긴 입금자명을 잘라서 보낸다면 [이름 앞자리 매칭](/matching-assist#이름-앞자리-매칭)을 켜 보세요.