연동 가이드

LunePay 연동 준비부터 자동 매칭까지

무통장 입금 자동 확인을 실제 서비스에 붙이는 과정을 단계별로 정리했습니다.

연동을 시작하기 전에 확인할 것

LunePay 연동의 목적은 입금 확인을 자동화해 운영 시간을 줄이는 것입니다. 이를 위해서는 먼저 운영 흐름을 정리해야 합니다. 주문 등록 시점, 입금 확인 시점, 고객 알림 시점이 명확해야 자동 매칭이 안정적으로 동작합니다.

운영 기준이 없다면 자동화도 효과를 내기 어렵습니다. 입금자명과 주문명 기준을 어떻게 맞출지, 동일 금액 주문이 발생했을 때 처리 규칙을 어떻게 둘지 먼저 정리해 두세요.

마지막으로 담당자 역할을 분리합니다. 계좌 관리, 주문 등록, 매칭 확인 담당자를 구분하면 문제 발생 시 원인을 빠르게 추적할 수 있습니다. 이 기본 정리가 연동 성공의 절반입니다.

연동 준비 단계에서 가장 많이 놓치는 것이 테스트 환경입니다. 운영 환경에 바로 붙이기 전에 테스트 주문, 테스트 입금, 테스트 매칭을 검증하세요. 이후 운영에 들어가면 예상치 못한 데이터 형태가 생기기 때문에 초기 테스트가 안전장치가 됩니다.

워크스페이스와 계좌 등록 흐름

첫 번째 단계는 워크스페이스 생성과 계좌 등록입니다. 워크스페이스는 실질적으로 사업 단위를 의미하며, 여러 사업을 운영한다면 워크스페이스를 분리하는 것이 관리에 유리합니다.

계좌 등록 시 은행 코드, 계좌번호, 예금주 정보를 정확히 입력해야 합니다. 이 정보는 SMS 계좌 매칭에 사용되기 때문에 오탈자가 있으면 입금이 정상적으로 매칭되지 않습니다.

여러 계좌를 운영하는 경우에도 문제는 없습니다. LunePay는 다계좌를 지원하고, 각 계좌에 대한 입금이 자동으로 수집됩니다. 중요한 것은 모든 계좌가 동일한 운영 규칙에 따라 등록되어야 한다는 점입니다.

계좌 등록 이후에는 실제 입금 SMS가 들어오는지 확인해야 합니다. 은행 앱에서 알림 수신번호를 LunePay 지정 번호로 설정하고, 소액 테스트 입금으로 정상 동작을 확인하세요.

주문 등록과 자동 매칭

입금 자동 매칭을 위해서는 주문 등록이 선행되어야 합니다. 주문 등록은 금액과 입금자명을 기준으로 하며, 이 값이 매칭의 기준이 됩니다.

주문 등록 시 주문번호, 이메일, 휴대폰 등 추가 정보를 넣어두면 운영 시 추적이 쉬워집니다. 특히 동일 금액 주문이 많을 경우 주문번호는 빠른 확인에 도움이 됩니다.

입금이 발생하면 은행 SMS를 기반으로 입금 정보가 수집되고, 주문과 자동 매칭됩니다. 매칭 결과는 입금 내역과 주문 내역에서 즉시 확인할 수 있습니다.

자동 매칭이 실패하는 경우도 있습니다. 이는 입금자명이 다르거나 금액이 변경된 경우입니다. 이때는 수동 매칭 기능으로 빠르게 처리할 수 있도록 운영 프로세스를 마련해야 합니다.

운영 체크리스트

연동 완료 후에는 운영 체크리스트를 주간 단위로 점검하세요. 미매칭 입금이 쌓이지 않는지, 동일 금액 주문의 매칭 정확도가 유지되는지 확인해야 합니다.

주문 등록 누락은 자동 매칭 실패의 가장 큰 원인입니다. 주문 등록이 늦어지는 구간이 있다면 프로세스를 개선해야 합니다. 주문이 늦게 등록되면 입금이 먼저 들어와도 매칭이 실패할 수 있습니다.

계좌 변경이나 은행 앱 설정 변경이 발생했을 때 즉시 반영할 수 있는 체계가 필요합니다. 운영 중 계좌가 변경되면 입금이 끊기는 문제가 생길 수 있습니다.

LunePay는 입금 확인 자동화에 집중된 도구입니다. 카드 결제나 결제 승인 기능은 제공하지 않으므로, 결제 영역은 별도의 시스템과 병행하는 것이 안전합니다.

마무리

LunePay 연동은 복잡하지 않습니다. 하지만 운영 규칙과 데이터 기준을 정리하지 않으면 자동화 효과가 떨어집니다. 연동은 기술 작업이 아니라 운영 설계와 함께 진행해야 합니다.

핵심은 ‘입금 확인을 자동화하되, 예외 상황을 처리할 수 있는 프로세스를 유지하는 것’입니다. 이 구조가 갖춰지면 자동 매칭은 안정적으로 동작하고 운영 효율이 크게 개선됩니다.