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

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

## 찾기

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

## 실패 이유 확인

대시보드 **입금 내역**에서 입금을 열면 **자동 매칭하지 않은 이유**가 나와요. API로는 [입금 단건 조회](/api-reference/transactions/get)의 `failureReason`으로 확인해요.

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

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

## 직접 매칭 [#추천-주문]

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

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

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

<img className="light-only" src="/images/deposits/unmatched/light.png" alt="자동 매칭하지 않은 이유와 추천 주문, 주문과 매칭 버튼이 있는 입금 상세" width="520" height="711" />
<img className="dark-only" src="/images/deposits/unmatched/dark.png" alt="자동 매칭하지 않은 이유와 추천 주문, 주문과 매칭 버튼이 있는 입금 상세" width="520" height="711" />

매칭되지 않은 입금의 상세

주문을 고르고 **주문과 매칭**을 누르면 주문이 결제 완료되고 [`invoice.paid`](/api-reference/webhooks/invoice-paid)가 가요. 직접 매칭에는 이런 규칙이 있어요.

- 결제 대기 주문과 만료된 주문에 매칭할 수 있어요. 취소된 주문에는 매칭할 수 없어요.
- 금액이 달라도 매칭할 수 있어요. 주문의 `paidAmount`에 실제 입금액이, `amountDiff`에 차액이 기록돼요.
- 매칭은 대시보드에서만 할 수 있어요. API로는 입금 없이 주문을 [결제 완료 처리](/api-reference/invoices/mark-as-paid)만 할 수 있어요.
- 추천 주문은 매칭 어시스트 설정과 관계없이 항상 보여 주고, 자동으로 매칭하지 않아요.

## 숨기기

주문과 관계없는 입금(개인 송금, 이자, 환불받은 돈)은 **숨기기**로 목록에서 치워요. 숨긴 입금은 상태가 `HIDDEN`이 되고, **숨긴 입금 보기**를 켜면 다시 보여요. **숨김 해제**로 되돌릴 수 있어요. 매칭되지 않은 입금만 숨길 수 있어요.

## 매칭 해제

잘못 매칭됐거나 구매자에게 환불했다면 입금 상세에서 **매칭 해제**를 눌러요. 자동 매칭과 직접 매칭 모두 해제할 수 있어요. 해제 사유로 **잘못 매칭됨**, **구매자 환불**, **기타** 중 하나를 골라요. **기타**는 메모가 필요해요.

<img className="light-only" src="/images/deposits/unmatch/light.png" alt="해제하면 바뀌는 점과 해제 사유를 고르는 매칭 해제 화면" width="520" height="522" />
<img className="dark-only" src="/images/deposits/unmatch/dark.png" alt="해제하면 바뀌는 점과 해제 사유를 고르는 매칭 해제 화면" width="520" height="522" />

매칭 해제

해제하면 이렇게 돼요.

- 입금은 `UNMATCHED`로 돌아가고, `unmatches`에 해제 기록이 쌓여요.
- 주문은 결제 대기로 돌아가요. 입금 기한이 지났으면 만료로 돌아가요.
- [`invoice.reopened`](/api-reference/webhooks/invoice-reopened) 웹훅이 가요. 쇼핑몰에서 배송을 멈추는 등 결제 완료 처리를 되돌려야 해요.
- 발급한 현금영수증과 카페24 주문 상태는 그대로예요. 필요하면 [현금영수증을 취소](/api-reference/cash-receipts/cancel)하세요.

해제한 주문은 다른 입금과 다시 매칭할 수 있어요.

## 경우별 처리

### 고객이 같은 금액을 두 번 보냈어요

첫 입금이 주문을 결제 완료로 바꾸면 두 번째 입금과 짝지을 주문이 없어서 `NO_CANDIDATE`로 남아요. 고객에게 환불하고 그 입금을 숨기거나, 같은 고객의 다른 주문이 있다면 그 주문에 직접 매칭하세요.

### 다른 이름으로 보냈어요

부모님 이름이나 회사 이름처럼 주문과 다른 이름으로 보내면 `NO_CANDIDATE`로 남아요. 금액이 같은 주문이 있으면 추천 주문에 **금액만 일치**로 나와요. 고객에게 확인한 뒤 직접 매칭하세요.

이런 일을 줄이려면 입금 안내에서 고객이 써야 할 입금자명을 눈에 띄게 보여 주세요. 페이싱크의 [입금 안내 페이지](/buyer-notices#입금-안내-페이지)에도 입금자명이 나와요.

### 입금 기한 뒤에 보냈어요

`ONLY_EXPIRED`예요. 만료된 주문에 직접 매칭하면 주문이 결제 완료되고 `invoice.paid`가 와요. 쇼핑몰이 만료된 주문의 재고를 이미 풀었다면 매칭하기 전에 처리 방침을 정하세요.

### 입금 알림이 오지 않았어요

입금 내역에 아예 없다면 페이싱크가 은행 문자를 받지 못했거나, 요금제의 [입금 감지 한도](/usage-and-overage)를 다 썼어요. 계좌가 [문자 미수신](/bank-accounts#문자가-오지-않을-때) 상태인지 확인하고, 입금을 확인한 주문은 [결제 완료 처리](/api-reference/invoices/mark-as-paid)하세요.
