가이드

입금 알림 연결

입금 계좌의 은행 알림을 오토페이 공용 수신번호로 연결하는 방법 (아직 안 되는 은행은 내 휴대폰으로 받기).

AutoTransPay 는 은행과 직접 연결하지 않습니다. 은행이 보내는 입출금 알림 문자를 받아 해석하는 방식이라, 은행 제휴나 공인인증서·스크래핑이 필요 없습니다.

기본은 공용 수신번호입니다. 입금 계좌를 등록하고, 은행의 입출금 알림을 받을 번호에 오토페이 공용 수신번호를 추가하면 끝납니다. 휴대폰을 따로 두거나 앱을 설치할 필요가 없습니다 → 콘솔에서 연결하기. 공용 수신번호가 아직 지원하지 않는 은행 계좌만 아래의 내 휴대폰으로 받기(수집기)로 연결합니다. 알림을 전달하는 휴대폰이나 채널을 수집기(collector) 라고 부릅니다.

콘솔에서 연결하기 (은행 알림 연결)

공용 수신번호는 콘솔에서 직접 연결합니다. 지금은 우리은행(2026-10-14 부터)·IBK기업은행(2026-10-22 부터) 계좌가 됩니다. 두 은행의 통지 신청 인증번호는 화면에 바로 표시됩니다(기업은행은 2026-11-16 부터). IBK 기업 인터넷뱅킹은 알림 받을 번호를 더할 때 인증번호 없이 바로 추가되므로 인증번호 단계를 건너뛰면 됩니다.

  1. 콘솔 → 입금 계좌 → 계좌 줄의 [연결하기]
  2. 은행·동의 — 조직 소유자가 공용 수신번호 이용 조건에 동의합니다.
  3. 번호 받기 — 화면에 공용 수신번호가 바로 보입니다(자리는 72시간 동안 예약). 은행 인터넷뱅킹·앱의 입출금 통지 서비스에서 알림 받을 번호에 이 번호를 추가합니다. 기존에 알림을 받던 번호는 그대로 둬도 됩니다.
  4. 인증번호 받기 — 은행이 공용 수신번호로 인증번호를 보내는 경우에만 씁니다. 화면에서 [인증번호 받기 시작]을 누른 뒤 은행에 인증번호를 요청하면, 이 화면에만 숫자가 표시됩니다(은행의 통지 신청 인증번호 문자로 확인된 형식은 바로, 그 밖의 문자는 본사 담당자 확인을 거쳐). 같은 번호에서는 한 번에 한 조직만 받으며, 받은 인증번호는 최대 15분 뒤 지워집니다.
  5. 인증번호 입력 — 표시된 숫자를 은행 화면에 입력해 통지 신청을 마칩니다.
  6. 확인 입금 — 화면에 나온 11~99원을 그 계좌로 30분 안에 입금합니다. 공용 수신번호가 그 계좌의 문자를 받을 준비를 마치면 [연결 확인 시작]이 켜지는데, 보통 은행에 번호를 넣는 사이에 끝나 있습니다. 그 입금 알림이 공용 수신번호로 들어오면 연결이 끝납니다. 확인 입금은 입금 확인 목록과 이용 건수에 들어가지 않습니다(같은 계좌의 알림을 휴대폰 수집기로도 받고 있으면 그쪽으로 미매칭 입금 1건이 보일 수 있습니다).
주의

AutoTransPay 직원은 전화·문자·메신저로 인증번호를 묻지 않습니다. 인증번호를 묻는 연락을 받으면 응하지 말고 알려 주세요.

연결 해지나 이용 조건 동의 철회는 고객센터로 요청하면 1영업일 안에 처리합니다. 끊은 뒤에도 은행 통지가 계속 오면 그 문자는 어느 조직에도 가지 않고 14일 뒤 지워지니, 은행의 문자 통지에서도 이 번호를 빼 주세요.

수집기 종류

공용 수신번호가 아직 지원하지 않는 은행 계좌에 씁니다. 콘솔 → 입금 계좌에서 그 계좌의 내 휴대폰으로 받기를 눌러 시작합니다.

종류 받을 수 있는 알림 추천 상황
안드로이드 문자 전달 앱 문자(SMS/LMS) 은행 입금 문자를 받는 경우. 가장 안정적
안드로이드 알림 전달 앱 앱 푸시 + 문자 카카오뱅크·토스뱅크·케이뱅크처럼 푸시만 오는 은행
iPhone 단축어 문자만 아이폰만 있고 은행 문자를 받는 경우
텔레그램 수집방 방에 올라온 글 여러 사람이 알림을 한곳에 모으는 경우

같은 계좌에 수집기를 두 대 이상 연결해도 됩니다. 같은 알림은 한 건으로 합쳐집니다.

수집기 만들기

  1. 콘솔 → 입금 계좌 → 그 계좌의 내 휴대폰으로 받기 → 휴대폰 연결에서 종류와 이름을 정합니다.
  2. 이 수집기가 담당할 입금 계좌를 고릅니다. (조직에 계좌가 하나면 생략해도 됩니다.)
  3. 발신번호 허용목록에 은행 대표번호를 넣습니다 (권장, 아래 참고).
  4. 발급된 수집기 토큰(atpc_…)을 복사합니다. 토큰은 발급 직후 한 번만 표시됩니다.
주의

수집기 토큰은 입금 알림을 올릴 수 있는 비밀값입니다. 분실·유출이 의심되면 콘솔에서 즉시 폐기하고 새로 발급하세요.

수집 API

모든 전달 방식은 결국 아래 API 하나로 모입니다.

POSThttps://www.autotranspay.com/api/v1/collect
주의

주소는 반드시 www 를 붙여 쓰세요. https://autotranspay.com(www 없음)은 리디렉션(308)이라, 전달 앱에 따라 알림이 도착하지 않습니다.

인증 — 아래 셋 중 하나로 토큰을 보냅니다.

방식 예
X-Collector-Token 헤더 (권장) X-Collector-Token: atpc_…
Authorization 헤더 Authorization: Bearer atpc_…
쿼리스트링 (헤더를 못 넣는 앱) https://www.autotranspay.com/api/v1/collect?token=atpc_…

본문 — JSON, form, 또는 원문 텍스트(text/plain)를 받습니다. 전달 앱마다 필드 이름이 달라서 넓게 받습니다.

의미 받는 필드 이름
알림 원문 (필수) text, msg, message, body, content
앱 패키지명 (푸시, 권장) package, package_name, packageName → 발신자 pkg:<패키지명>
발신번호·앱 이름 from, sender, phone, title
수신 시각 (선택) received_at, time, timestamp, receivedStamp

수신 시각은 epoch(초/밀리초), ISO 8601, YYYY-MM-DD HH:mm(:ss)(한국 시간)을 받습니다. 없으면 서버 수신 시각을 씁니다.

Shell
curl https://www.autotranspay.com/api/v1/collect \
  -H "X-Collector-Token: atpc_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "[Web발신]\n우리 09/28 23:14\n*456789\n입금 122,500원\n홍길동",
    "from": "15885000"
  }'
응답 200
{
  "object": "collect_result",
  "outcome": "deposit",
  "deposit_id": "a3e1b7c2-4d5f-4a6b-8c9d-0e1f2a3b4c5d",
  "status": "matched",
  "order_number": "ORD-1042",
  "parsed": {
    "kind": "deposit",
    "amount": 122500,
    "depositor_name": "홍길동",
    "bank_code": "WOORI",
    "confidence": 0.9
  }
}
outcome 의미
deposit 입금으로 저장되고 매칭까지 끝남 (status 에 결과)
duplicate 이미 받은 알림 (다른 수집기가 먼저 올림)
ignored 출금·광고 등 입금이 아닌 알림
unparsed 입금 알림으로 보이지만 금액을 읽지 못함 (운영 알림 발송). 이름만 못 읽은 입금은 deposit 으로 이름 없이 기록
unrouted 어느 계좌의 입금인지 정하지 못함 (계좌 등록·연결 확인)
rejected 발신번호 허용목록에 없는 발신번호
참고

수집 API 로 들어온 입금은 항상 운영 모드 입금입니다. 연동 테스트는 샌드박스 API로 하세요.

안드로이드 — 문자 전달 앱

Play 스토어의 "SMS 전달(SMS forwarder / SMS to URL)" 류 앱은 대부분 웹훅(HTTP) 전달을 지원합니다. 앱마다 메뉴 이름은 달라도 설정할 값은 같습니다.

항목 값
전달 방식 Webhook / HTTP / URL
URL https://www.autotranspay.com/api/v1/collect
메서드 POST
헤더 X-Collector-Token: atpc_… (헤더를 못 넣으면 URL 에 ?token=atpc_…)
본문 {"text": "<문자 내용>", "from": "<발신번호>"} — 앱의 치환 변수 사용
필터 (권장) 발신번호가 은행 대표번호인 문자만 (입금·출금 알림 모두 — 출금도 보내야 잔액 연속성 검사가 이어집니다)

예를 들어 앱의 치환 변수가 %text%, %from% 이라면 본문 템플릿은 다음과 같습니다.

JSON
{ "text": "%text%", "from": "%from%", "received_at": "%sentStamp%" }

앱이 자체 형식(From: … / Message: …)으로만 보내더라도 AutoTransPay 가 본문만 꺼내 해석합니다.

꼭 설정할 것

  • 휴대폰 설정에서 전달 앱의 배터리 최적화 예외, 백그라운드 데이터 허용을 켭니다.
  • 기본 문자 앱의 스팸 필터가 은행 문자를 가로채지 않는지 확인합니다.
  • 전달 앱의 테스트 전송으로 콘솔 → 수집기 → 최근 수신에 기록이 남는지 확인합니다.

안드로이드 — 알림 전달 앱

카카오뱅크·토스뱅크·케이뱅크는 입금 알림을 앱 푸시로만 보냅니다. 이 경우 "알림 전달(Notification forwarder)" 류 앱으로 알림 접근 권한을 주고 은행 앱의 알림만 전달하게 설정합니다.

항목 값
대상 앱 은행 앱만 선택 (카카오뱅크, 토스, 케이뱅크 등)
URL · 헤더 문자 전달 앱과 동일
본문 {"text": "<알림 내용>", "title": "<알림 제목>", "package": "<앱 패키지명>"}

text 에는 알림 내용만 넣으세요. 제목(앱 이름 등)을 내용 앞에 붙이면 앱 이름이 입금자명으로 읽힐 수 있습니다. 제목은 title 로 따로 보내도 되지만 해석에는 쓰지 않습니다. 앱 패키지명(package)을 꼭 함께 보내고, 허용목록에는 pkg:<패키지명>(예: pkg:com.kakaobank.channel)을 등록하세요. 패키지명은 처음 받은 알림의 최근 수신 행에 pkg:… 로 찍히니, 그 행의 [허용목록에 추가]를 누르면 됩니다. 알림 제목·본문은 카카오톡 대화명 등으로 흉내낼 수 있어서 pkg: 발신자는 package 필드로 보낸 것만 인정합니다.

주의

알림 내용을 JSON 본문에 그대로 끼워 넣으면 줄바꿈·따옴표 때문에 JSON 이 깨져 요청이 거부(400)되고 기록도 남지 않습니다. 앱의 JSON 변환 기능을 쓰세요 — 예: MacroDroid 는 사전(Dictionary) 변수에 text·package 를 담고 본문에 {lvjson=변수이름}, Automate 는 jsonEncode({...}). JSON 변환이 없는 앱은 폼(키-값, application/x-www-form-urlencoded) 방식으로 보내세요.

iPhone — 단축어 자동화

iOS 는 다른 앱의 푸시 알림을 읽을 수 없어서 문자로 오는 입금 알림만 전달할 수 있습니다. 푸시 전용 은행 계좌는 안드로이드 수집기가 필요합니다.

  1. 단축어 앱 → 자동화 → 새로운 자동화 → 메시지를 고릅니다.
  2. 조건: 메시지에 "입금" 포함, 발신자는 은행 대표번호로 지정합니다.
  3. 즉시 실행을 켭니다 (실행 전 확인 끄기).
  4. 동작 URL 콘텐츠 가져오기를 추가합니다.
    • URL: https://www.autotranspay.com/api/v1/collect
    • 방법: POST
    • 헤더: X-Collector-Token = atpc_…
    • 본문 요청: JSON — text = 단축어 입력(메시지 내용), from = 발신자
  5. 은행 문자를 한 번 받아 보고 콘솔 → 수집기에서 수신 기록을 확인합니다.

텔레그램 수집방

여러 사람이 받은 알림을 한 텔레그램 방으로 모으거나, 전달 앱이 텔레그램으로만 보낼 수 있을 때 씁니다.

  1. 콘솔 → 수집기 → 텔레그램 수집방에서 연결 코드를 발급합니다.
  2. AutoTransPay 봇을 방(그룹 또는 채널)에 초대합니다.
  3. 방에서 /start 코드 를 보냅니다. "입금문자 수집방으로 연결되었습니다" 답장이 오면 완료입니다.
  4. 이후 /start 를 보낸 사람이 그 방에 올리는 글만 입금 알림으로 수집됩니다. 다른 멤버의 글은 무시합니다 (채널은 관리자만 글을 쓸 수 있으므로 채널 글 전체를 수집).
주의

텔레그램 봇은 다른 봇이 그룹에 쓴 글을 받지 못합니다. 전달 앱이 봇 계정으로 글을 올린다면 그룹이 아니라 채널을 수집방으로 쓰세요.

하트비트

수집기 휴대폰이 꺼지거나 앱이 종료되면 입금 알림이 조용히 끊깁니다. 하트비트를 10분마다 보내 주세요. 30분 넘게 하트비트가 없으면 연결된 알림 채널(텔레그램·디스코드·슬랙)로 "신호 끊김" 경보를 보내고, 콘솔에도 신호 끊김으로 표시합니다. 다시 들어오면 "다시 연결됨"을 한 번 알립니다.

참고

하트비트를 보내지 않는 수집기(문자만 전달하는 앱)는 조용한 날과 고장을 구분할 수 없어 경보를 보내지 않고, 24시간 동안 아무것도 받지 못하면 콘솔에만 24시간 수신 없음으로 표시합니다. 허용목록에 없는 번호에서 온 입금 문자를 거부하면 번호별로 한 번 알려 드립니다 (은행 번호가 바뀐 경우 대비).

POSThttps://www.autotranspay.com/api/v1/collect/heartbeat
Shell
curl https://www.autotranspay.com/api/v1/collect/heartbeat \
  -H "X-Collector-Token: atpc_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "battery": 82, "charging": true, "app_version": "1.4.2" }'
응답 200
{ "object": "heartbeat", "ok": true, "server_time": "2026-09-29T05:20:00.000Z" }

본문의 문자열·숫자·불리언 필드(최대 20개)가 수집기 상태로 저장됩니다. 전달 앱에 주기 실행 기능이 있다면 5~15분 간격을 권장합니다. 입금 알림이 들어올 때도 마지막 수신 시각이 갱신됩니다.

발신번호 허용목록

누군가 수집기 휴대폰에 은행을 사칭한 문자(070·웹문자·해외문자 등)를 보내 가짜 입금을 만들려 할 수 있습니다. 그래서 자동확정은 발신번호 허용목록이 있는 수집기에서만 동작합니다. 허용목록이 없는 수집기의 입금은 모두 확인 필요(sender_unverified)로 올라옵니다.

  • 번호는 숫자만 비교합니다 (1588-5000 = 15885000).
  • 목록에 없는 발신번호, 그리고 발신번호(from)가 없는 요청은 거부(rejected)합니다. 전달 앱 본문에 반드시 발신번호를 넣으세요.
  • 은행 대표번호는 은행·알림 종류마다 다를 수 있으니, 실제로 받은 입금 문자의 발신번호를 그대로 등록하세요. 콘솔 → 수집기 → 최근 수신 기록에서 발신번호를 확인할 수 있습니다.
  • 국내 문자는 발신번호 사전등록제 때문에 은행 대표번호를 사칭해 보낼 수 없습니다. 이것이 허용목록을 기준으로 삼는 이유입니다.

허용목록이 있어도 다음 입금은 자동확정하지 않고 확인 필요로 보냅니다 → 위조 의심 신호.

  • 개인 휴대폰 번호(010…)나 해외에서 온 입금 문자
  • 입금자명에 금액·입금·잔액 같은 글자를 넣어 금액을 헷갈리게 만든 입금
  • 문자 속 은행·계좌가 등록 계좌와 맞지 않는 입금
  • 직전 잔액 + 입금액이 새 잔액과 맞지 않는 입금 — 출금 알림도 함께 전달하면 잔액이 계속 이어져 오탐이 줄어듭니다

위조 대응은 이것만이 아닙니다. 자동확정 금액 상한도 함께 쓰세요 → 보안.

수신번호 전략: 공용 수신번호와 내 휴대폰

내 휴대폰 (BYOD — 공용 수신번호가 아직 안 되는 은행)

가맹점이 자기 휴대폰을 수집기로 씁니다. 수집기 토큰이 곧 조직을 가리키므로, 문자에 찍힌 계좌 뒷자리는 조직 안의 계좌 중 어느 계좌인지만 고르면 됩니다. 다른 가맹점과 섞일 일이 없습니다.

공용 수신번호 (Managed, 기본)

가맹점은 은행 입금 알림을 받는 번호에 AutoTransPay 가 운영하는 공용 수신번호를 추가합니다(기존에 알림을 받던 번호는 그대로 둘 수 있습니다). 연결 순서는 위에 있습니다. 이때 한 번호에 여러 가맹점의 알림이 섞여 들어오므로 "이 문자가 어느 가맹점 계좌의 입금인가"를 문자만 보고 가려야 합니다.

받는 정보, 인증번호 전달, 보관 기간, 책임은 공용 수신번호 이용 조건(2026-10-14 시행)에 있습니다.

문제는 은행 문자의 계좌번호가 마스킹되어 있다는 점입니다. 은행마다 남겨 주는 자리가 다릅니다.

은행 문자 속 계좌 표기 예 식별에 쓰는 키
우리은행 *456789 뒤 6자리
IBK기업은행 469***03801011 뒤 4자리
KB국민은행 279801**027 뒤 3자리
그 외 110-***-123456 등 뒤 4자리

뒤 3~4자리는 가맹점이 많아지면 쉽게 겹칩니다. 같은 번호로 들어오는 두 가맹점의 KB 계좌가 모두 …027 로 끝나면 문자만으로는 누구의 입금인지 알 수 없습니다. 수신번호를 은행마다 따로 두는 방식은 한 번호 안에서 겹칠 확률을 낮추는 방법입니다.

AutoTransPay 는 (수신번호, 은행, 마스킹 키) 조합이 겹치지 않도록 DB 제약으로 막습니다. 계좌를 공용 수신번호에 연결할 때 이미 같은 조합이 있으면 연결 자체가 거부되고, 겹치지 않는 다른 수신번호로 배정합니다. 이 제약 덕분에 수신번호 하나에 여러 은행을 담을 수 있습니다. 비어 있는 번호가 없으면 번호를 준비할 때까지 연결을 기다립니다.