API 문서

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

결제 API

Benta Payments API의 결제 관련 엔드포인트들입니다. 결제 생성 및 결제 확인 기능을 제공합니다.

모든 API 요청에는 인증이 필요합니다. 인증 방법에 대한 자세한 내용은 인증 섹션을 참조하세요.

📤 결제 생성

새로운 결제를 생성합니다.

POST https://api.benta.im/payments

매개변수

이름	타입	필수	설명
token	string	필수	애플리케이션 API 토큰
title	string	필수	결제 타이틀
identifier	string	필수	결제 식별자
icon	string	선택	결제 페이지의 커스텀 아이콘 URL (https://로 시작해야 함)
amount	number	선택	총 결제 금액 (숫자) \| 가격을 고정 기능을 사용하면 필수 항목입니다.
items	array(object)	선택	결제 항목 목록 (배열)
items.name	string	선택	결제 항목 이름 (아이템 필드 사용 시 필수)
items.price	number	선택	결제 항목 가격 (아이템 필드 사용 시 필수)
items.count	number	선택	결제 항목 수량
items.icon	string	선택	결제 항목 아이콘 URL (https://로 시작해야 함)

요청 예시

curl -X POST "https://api.benta.im/payments" \
  -H "Content-Type: application/json" \
  -d '{
    "token": "애플리케이션_API_토큰",
    "title": "결제 타이틀",
    "identifier": "결제_식별자",
    "icon": "https://example.com/icon.png",
    "amount": 10000,
    "items": [
      {
        "name": "상품명",
        "price": 10000,
        "count": 1,
        "icon": "https://example.com/item-icon.png"
      }
    ]
  }'

📥 완료된 결제 가져오기 (Polling)

입금이 확인된 결제가 있다면 가져와서 승인 처리하고 결제를 가져옵니다.

GET https://api.benta.im/callback/rest

매개변수

이름	타입	필수	설명
token	string	필수	애플리케이션 API 토큰

요청 예시

curl -X GET "https://api.benta.im/callback/rest?token={애플리케이션_API_토큰}" \
  -H "Content-Type: application/json"

📤 결제 검증 요청 (Webhook)

Webhook으로 온 결제를 검증합니다. COMPLETE로 응답이 올 시 검증된 결제입니다.

POST https://api.benta.im/payments/confirm

매개변수

이름	타입	필수	설명
payToken	string	필수	결제 토큰
token	string	필수	애플리케이션 API 토큰

요청 예시

curl -X POST "https://api.benta.im/payments/confirm" \
  -H "Content-Type: application/json" \
  -d '{
    "payToken": "2f9a7b5c-1d3e-4f8a-9b2c-6d7e8f9a0b1c",
    "token": "애플리케이션_API_토큰"
  }'