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 | 인증 실패 |