연락처 송금 외부 연동과 계층별 수수료 정산 개선

연락처송금 외부 연동 모드 (EXTERNAL) 지원

2026-04-03에 연락처 송금 관련 기능을 추가하거나 개선했음.

연락처 송금 흐름은 대략 이렇게 됨:

입금 알림 수신 (Android 앱)
  → 서버로 원본 메시지 전송
  → 주문 매칭 (금액 + 발신자 + 시간)
  → 은행 핸들러 실행 (Playwright)
    → 로그인 → 수취인 입력 → 이체 → 완료 감지
  → 주문 상태 업데이트
  → 알림 발송

은행별 핸들러는 추상 클래스를 상속받아서 구현함. 은행마다 UI 구조가 달라서 셀렉터가 달라지는데, 셀렉터를 DB에 캐시해두고 성공한 케이스를 자가학습하는 구조를 붙였음.

수수료 분배는 유통 계층 구조에 따라 차액을 위로 전달하는 방식임. 각 유통 단계의 요율 차이가 해당 계층의 수익이 됨.

작업 규모는 크지 않았지만 운영 안정성을 위한 필요한 변경이었음. 이런 작은 수정들이 쌓여서 전체 시스템의 신뢰도를 높임.

수수료 계산 로직은 금전 관련이라 오류가 나면 바로 신뢰 손상으로 이어짐. 계층별 요율을 다르게 적용하면서 올림/버림 처리도 결과에 영향을 미침.

일반적으로 원 단위 반올림은 사용자에게 유리한 방향(내림)으로 처리함. 수수료를 내는 쪽은 내림으로 덜 내고, 받는 쪽은 올림 없이 정확하게 받는 구조가 분쟁을 줄임.

정산 배치는 멱등성이 중요함. 같은 기간을 두 번 실행해도 결과가 달라지면 안 됨.

정산 화면에서 사용자가 가장 많이 보는 건 결국 숫자임. 총 거래액, 수수료, 실수령액을 명확하게 보여주는 게 중요함.

금액 표기는 천 단위 구분자와 '원' 단위를 일관되게 적용하고, 마이너스 금액은 빨간색으로 표시해서 직관적으로 구분할 수 있게 하는 게 좋음.