API 문서

Benta Payments API는 결제 처리 서비스로, 모바일 알림을 통한 은행 입금 확인을 자동화하는 시스템입니다. 이 문서에서는 API의 사용 방법을 상세히 설명합니다.

지원 은행

Benta Payments가 지원하는 은행 목록입니다. 모바일 앱에서 이 은행들의 입금 알림을 자동으로 인식합니다.

은행명	패키지명	설명	다운로드
은행 목록을 불러오는 중...

은행 정보 API

지원되는 은행 목록을 프로그래밍 방식으로 조회할 수 있습니다.

기본 조회

GET /mobile/banks

은행 이름, 패키지명, 로고 정보를 반환합니다.

응답 예시:

[
  {
    "name": "카카오뱅크",
    "package": "com.kakaobank.channel",
    "logo": "https://..."
  },
  {
    "name": "하나은행",
    "package": "com.kebhana.hanapush",
    "logo": "https://..."
  }
]

상세 정보 조회

GET /mobile/banks?details=true

추가 필드를 포함한 상세 정보를 반환합니다.

응답 예시:

[
  {
    "id": 1,
    "name": "카카오뱅크",
    "package": "com.kakaobank.channel",
    "logo": "https://...",
    "status": true,
    "icon": "https://...",
    "app_package": "com.kakaobank.channel",
    "last_updated_ts": "2023-05-01T12:00:00Z"
  }
]

모바일 앱 연동 가이드

알림 권한 획득: Android의 NotificationListenerService 권한을 사용자로부터 획득합니다.

패키지명 필터링: 위 목록의 패키지명으로 은행 알림만 필터링합니다.

알림 데이터 추출: 알림의 title과 subtitle(또는 text)를 추출합니다.

API 전송: POST /mobile/deposit로 알림 데이터를 전송합니다.