Benta API

API 문서

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

인증

Benta Payments API는 서비스의 안전한 사용을 위해 인증이 필요합니다. 모든 API 요청은 인증이 필요하며, 인증 실패 시 오류가 반환됩니다.

인증 방식

API 토큰

결제 생성 및 확인을 위한 서버-서버 통신에 사용됩니다.

사용 방법

요청 본문 또는 쿼리 파라미터에 `token` 필드로 전달합니다.

예제

{
  "token": "your_api_token",
  "title": "결제 제목",
  "identifier": "고유_식별자",
  ...
}

보안 모범 사례

API 토큰 보안

  • API 토큰을 소스 코드나 공개 저장소에 저장하지 마세요.
  • 토큰은 환경 변수나 안전한 시크릿 관리 서비스를 통해 관리하세요.
  • 정기적으로 토큰을 교체하는 것이 좋습니다.

인증 관련 오류 코드

오류 코드설명
NO_API_TOKEN / NO_TOKEN
API 토큰/앱 로그인 키 누락
INVALID_API_TOKEN
유효하지 않은 API 토큰
UNAUTHORIZED
인증 실패