매칭 동작 방식

입금 문자가 들어왔을 때 페이싱크가 결제 대기 주문을 찾아 결제 완료로 바꾸는 규칙, 맞는 주문이 여러 건일 때의 처리, 매칭 방식 값을 설명해요.

은행 입금 문자가 들어오면 페이싱크는 입금을 기록하고 바로 맞는 주문을 찾아요. 주문을 찾으면 결제 완료로 바꾸고 invoice.paid 웹훅을 보내요. 찾지 못한 입금은 매칭되지 않은 입금으로 남아요.

기본 매칭 조건

아래 조건을 모두 만족하는 주문을 찾아요.

입금자명이 괄호 때문에 다르거나, 은행이 긴 이름을 잘라 보내거나, 금액이 몇백 원 다르게 들어오는 일이 잦다면 매칭 어시스트 규칙을 켜세요. 기본 조건으로 찾은 주문이 없을 때만 규칙을 적용해요.

입금 기한이 지난 주문은 상태가 아직 EXPIRED로 바뀌기 전이어도 자동 매칭에서 빠져요. 만료된 주문에 들어온 입금은 대시보드에서 직접 매칭할 수 있어요.

주문 하나에 입금 하나

주문 하나에는 입금 하나만 매칭돼요. 결제 완료된 주문에는 더 이상 입금이 매칭되지 않아서, 고객이 같은 금액을 두 번 보내면 두 번째 입금은 매칭되지 않은 채로 남아요. 금액을 나눠 보낸 입금도 각각 금액이 달라서 매칭되지 않아요.

그래서 페이싱크는 입금 하나가 어느 주문의 것인지 헷갈리지 않도록, 같은 입금자명과 금액으로 결제 대기 중인 주문을 받을 계좌가 겹치게 두 개 만들지 못하게 해요. 새 주문은 409, 220010으로 실패하고, 응답의 data에 이미 있는 주문의 invoiceId와 number가 와요. 받을 계좌가 겹치는 기준은 주문 충돌 규칙을 참고하세요.

맞는 주문이 여러 개일 때

주문 충돌 규칙이 있어도 매칭 어시스트 규칙을 켜면 맞는 주문이 두 건 이상 나올 수 있어요. 예를 들어 띄어쓰기를 빼고 비교하면 박 지훈과 박지훈 주문이 모두 맞아요. 이때 어떻게 할지 대시보드 자동화에서 정해요.

금액이 조금 달라도 매칭 규칙은 이 설정과 관계없이 주문이 한 건일 때만 매칭해요.

매칭 방식 확인

입금 API의 match.method와 주문 API의 매칭 정보로 입금이 어떤 방식으로 매칭됐는지 알 수 있어요.

v1 API에서는 matchMethod에 같은 값이 와요.

주문의 paidTrigger로는 주문이 어떻게 결제 완료됐는지 알 수 있어요. 자동 매칭은 AUTOMATIC_MATCHING, 대시보드 수동 매칭은 MANUAL_MATCHING, 대시보드의 결제 완료로 표시는 MANUAL_APPROVE, API의 결제 완료 처리는 API_CALL이에요.

매칭 뒤에 일어나는 일

• 주문이 PAID가 되고 paidAmount, paidAt, matchedTransactionId가 채워져요.
• invoice.paid 웹훅이 가요.
• 구매자 이메일이 있으면 결제 완료 메일을 보내요.
• 주문에 현금영수증 정보가 있으면 현금영수증을 자동으로 발급해요.
• 카페24 주문이면 카페24 주문을 입금 확인 상태로 바꿔요.