매칭되지 않은 입금

자동 매칭에 실패한 입금을 찾고, 실패 이유를 확인하고, 추천 주문으로 직접 매칭하거나 숨기는 방법이에요. 잘못된 매칭을 해제하는 방법과 자주 생기는 경우별 처리도 정리했어요.

맞는 주문을 찾지 못한 입금은 UNMATCHED 상태로 남아요. 이런 입금은 주문을 결제 완료로 바꾸지 않으니, 누군가 확인하고 처리해야 해요.

찾기

어디서	방법
대시보드	입금 내역에서 상태를 매칭 실패로 걸러요.
API	입금 내역 목록 조회에 `status=UNMATCHED`를 넣어요.
이메일	이메일 알림에서 매칭 실패 입금을 켜요.
디스코드, 슬랙	실시간 알림 채널에서 매칭 실패를 골라요.
웹훅	`transaction.created`의 `status`가 `UNMATCHED`예요.

실패 이유 확인

대시보드 입금 내역에서 입금을 열면 자동 매칭하지 않은 이유가 나와요. API로는 입금 단건 조회의 failureReason으로 확인해요.

`failureReason`	뜻	할 일
`NO_CANDIDATE`	입금자명과 금액이 맞는 결제 대기 주문이 없어요.	구매자가 다른 이름으로 보냈는지, 주문을 만들지 않았는지 확인해요.
`MULTIPLE_EXACT`	금액이 같은 결제 대기 주문이 여러 건이라 자동으로 고르지 않았어요.	직접 골라 매칭해요. 자주 생기면 맞는 주문이 여러 개일 때 설정을 바꿔요.
`MULTIPLE_RULE`	매칭 규칙에 맞는 주문이 여러 건이라 자동으로 고르지 않았어요.	직접 골라 매칭해요.
`ONLY_EXPIRED`	맞는 주문이 이미 만료됐어요.	구매자가 기한 뒤에 보냈어요. 주문을 살릴지 환불할지 정해요.
`ONLY_CANCELED`	맞는 주문이 이미 취소됐어요.	취소된 주문은 결제 완료로 바꿀 수 없어요. 환불하거나 새 주문을 만들어 매칭해요.
`AMOUNT_MISMATCH`	입금자명은 맞지만 금액이 달라요.	덜 내거나 더 낸 입금이에요. 차액을 정리하고 직접 매칭해요. 자주 생기면 금액이 조금 달라도 매칭을 켜요.

매칭을 해제한 입금은 failureReason이 null이에요.

직접 매칭

대시보드 입금 내역에서 매칭되지 않은 입금을 열면 추천 주문을 최대 5건 보여 줘요. 같은 금액이거나 이름이 비슷한 결제 대기 주문과 만료된 주문 중에서, 이 입금 계좌로 받을 수 있는 주문만 골라요. 원하는 주문이 없으면 다른 주문 검색으로 찾아요.

추천 주문은 이름이 비슷한 순서로 정렬해요. 비슷한 정도가 같으면 금액이 같은 주문, 만료되지 않은 주문, 입금 시각과 주문 생성 시각이 가까운 주문 순서로 먼저 나와요. 각 주문에는 무엇이 맞는지 표시돼요.

표시	뜻
이름·금액 일치	입금자명과 금액이 모두 같아요.
괄호 제거한 이름·금액 일치	괄호를 빼면 이름이 같고 금액도 같아요.
대소문자 무시한 이름·금액 일치	대소문자를 구분하지 않으면 이름이 같고 금액도 같아요.
이름 앞자리·금액 일치	한 이름이 다른 이름으로 시작하고 금액이 같아요.
이름 일부·금액 일치	한 이름이 다른 이름 안에 들어 있고 금액이 같아요.
금액만 일치	이름은 비슷하지 않고 금액만 같아요.