페이싱크 개발자센터
페이싱크로 무통장입금을 자동 확인하는 방법과 REST API, 웹훅 사용법을 안내해요.
페이싱크는 판매자의 은행 계좌로 들어온 입금을 확인해서 주문을 결제 완료로 바꿔 줘요. 은행이 보내는 입금 알림 문자를 페이싱크가 받아, 입금자명과 금액이 같은 주문을 찾아요. 주문이 결제 완료되면 등록한 웹훅 URL로 이벤트를 보내요.
연동 방법 고르기
| 방법 | 어울리는 경우 | 시작할 곳 |
|---|---|---|
| API와 웹훅 | 직접 만든 쇼핑몰이나 서비스에서 주문을 만들고 결제 완료를 받아요. | 빠른 시작, 쇼핑몰 결제 연동 |
| 카페24 연동 | 카페24 쇼핑몰을 쓰고, 코드 없이 입금 확인을 자동으로 처리해요. | 카페24 연동 |
| 대시보드만 | 주문이 많지 않아서 대시보드에서 주문을 직접 만들고 입금을 확인해요. | 워크스페이스와 멤버, 계좌 연결 |
어떤 방법이든 계좌 연결은 먼저 해야 해요. 페이싱크가 입금을 알 수 있는 길은 연결한 계좌의 입금 알림 문자뿐이에요.
둘러보기
빠른 시작
계좌 연결부터 첫 주문 결제 완료까지 한 번에 따라 해요.
핵심 개념
워크스페이스, 주문, 입금, 매칭과 주문 상태를 정리했어요.
입금 매칭
페이싱크가 입금을 주문에 연결하는 규칙과 실패했을 때의 처리를 알아봐요.
쇼핑몰 결제 연동
주문 생성, 입금 안내, 웹훅 수신을 Node.js 코드로 구현해요.
API 레퍼런스
인증, 응답 형식, 엔드포인트별 요청과 응답을 확인해요.
웹훅
서명 검증 방법과 이벤트별 페이로드를 확인해요.
TypeScript, Python, Go, Java, Kotlin, PHP로 만든 예제 서버는 언어별 예제 코드에 있어요. Java와 Kotlin은 SDK도 있어요.
API 버전
지금 API는 v2예요. 예전에 v1 API(/v1/...)나 v1 웹훅으로 연동한 서버는 그대로 동작해요. v1 문서는 API 레퍼런스 (v1)에 남겨 뒀어요.
문의
사용하는 은행이 지원 목록에 없거나 연동 중 막히는 부분이 있으면 paysync.kr 화면의 상담 위젯이나 디스코드 커뮤니티로 알려 주세요.