정산 가이드

ONDA 플랫폼의 정산 프로세스와 입금 일정을 안내합니다.

정산 가이드#

ONDA API를 통해 발생한 예약에 대한 정산 프로세스, 입금 일정, 세금계산서 발행 등을 안내합니다.

정산 프로세스 개요#

정산 주기#

등급별 정산 일정#

정산 기준일#

정산은 체크아웃 완료 시점을 기준으로 합니다.

정산 상세 흐름#

1. 체크아웃 완료#

# 체크아웃 시점 예시
reservation = {
    "id": "res_abc123",
    "status": "checked_out",
    "check_in": "2026-02-15",
    "check_out": "2026-02-16",
    "checked_out_at": "2026-02-16T11:00:00Z",  # 체크아웃 완료 시각
    "pricing": {
        "total": 154000,  # 총 예약 금액
        "currency": "KRW"
    },
    "commission": {
        "rate": 0.15,      # 15% (Standard 등급)
        "amount": 23100    # 수수료
    }
}

# 숙박 시설 정산 예정 금액
payout_amount = reservation["pricing"]["total"] - reservation["commission"]["amount"]
print(f"정산 예정 금액: {payout_amount:,}원")  # 130,900원

2. 정산 확정#

매월 1일과 16일, 지정된 기간의 체크아웃 완료 건을 집계합니다.

2월 정산 예시:

# 2월 1일 정산 집계 예시
settlement_period = {
    "settlement_date": "2026-02-01",
    "period_start": "2026-01-16T00:00:00Z",
    "period_end": "2026-01-31T23:59:59Z",
    "reservations": [
        {
            "id": "res_001",
            "checked_out_at": "2026-01-20T11:00:00Z",
            "total": 154000,
            "commission": 23100,
            "payout": 130900
        },
        {
            "id": "res_002",
            "checked_out_at": "2026-01-25T10:30:00Z",
            "total": 200000,
            "commission": 30000,
            "payout": 170000
        }
        # ... 더 많은 예약
    ],
    "summary": {
        "total_reservations": 150,
        "gross_revenue": 22500000,      # 총 매출
        "total_commission": 3375000,    # 총 수수료
        "net_payout": 19125000          # 실 정산 금액
    }
}

3. 입금 처리#

정산 확정 후 영업일 기준 3~5일 이내에 등록된 계좌로 입금됩니다.

입금 처리 일정:

정산일: 2026-02-01 (토요일)
  ↓
영업일 계산: 월(3), 화(4), 수(5), 목(6), 금(7)
  ↓
입금 예정: 2026-02-04 ~ 2026-02-06
  ↓
실제 입금: 2026-02-05 (수요일) ✅

정산 내역 확인#

대시보드에서 확인#

개발자 센터 대시보드에서 실시간으로 정산 내역을 확인할 수 있습니다.

경로: 대시보드 > 정산 관리

확인 가능한 정보:

• 정산 예정 금액 (체크아웃 완료, 입금 대기)
• 정산 완료 내역 (입금 완료)
• 정산 상세 내역 (예약별 수수료 및 정산액)
• 월별/분기별/연간 통계

API로 조회#

import requests

headers = {"Authorization": f"Bearer {access_token}"}

# 최근 정산 내역 조회
response = requests.get(
    "https://api.onda.me/v1/settlements",
    headers=headers,
    params={
        "limit": 10,
        "status": "completed"
    }
)

settlements = response.json()

for settlement in settlements["data"]:
    print(f"정산 ID: {settlement['id']}")
    print(f"정산 기간: {settlement['period_start']} ~ {settlement['period_end']}")
    print(f"예약 건수: {settlement['reservation_count']}건")
    print(f"총 매출: {settlement['gross_revenue']:,}원")
    print(f"수수료: {settlement['total_commission']:,}원")
    print(f"정산 금액: {settlement['net_payout']:,}원")
    print(f"입금일: {settlement['payout_date']}")
    print(f"입금 상태: {settlement['payout_status']}")
    print("---")

응답 예시:

{
  "data": [
    {
      "id": "settle_xyz123",
      "settlement_date": "2026-02-01",
      "period_start": "2026-01-16T00:00:00Z",
      "period_end": "2026-01-31T23:59:59Z",
      "reservation_count": 150,
      "gross_revenue": 22500000,
      "total_commission": 3375000,
      "net_payout": 19125000,
      "currency": "KRW",
      "payout_date": "2026-02-05",
      "payout_status": "completed",
      "payout_method": "bank_transfer",
      "bank_account": {
        "bank_name": "신한은행",
        "account_number": "****1234",
        "account_holder": "주식회사 예시"
      }
    }
  ],
  "meta": {
    "total": 24,
    "page": 1,
    "limit": 10,
    "has_more": true
  }
}

특정 정산 상세 조회#

settlement_id = "settle_xyz123"

response = requests.get(
    f"https://api.onda.me/v1/settlements/{settlement_id}",
    headers=headers,
    params={"include": "reservations"}
)

settlement_detail = response.json()

# 정산에 포함된 모든 예약 확인
for reservation in settlement_detail["reservations"]:
    print(f"{reservation['confirmation_number']}: {reservation['payout_amount']:,}원")

정산 상태값#

상태별 처리#

def check_settlement_status(settlement):
    """정산 상태별 안내"""
    status = settlement["status"]

    if status == "pending":
        next_date = settlement["next_settlement_date"]
        print(f"다음 정산 예정일: {next_date}")

    elif status == "confirmed":
        payout_date = settlement["estimated_payout_date"]
        print(f"입금 예정일: {payout_date}")

    elif status == "processing":
        print("입금 처리 중입니다. 곧 완료됩니다.")

    elif status == "completed":
        payout_date = settlement["payout_date"]
        amount = settlement["net_payout"]
        print(f"{payout_date}에 {amount:,}원 입금 완료")

    elif status == "failed":
        reason = settlement.get("failure_reason", "알 수 없음")
        print(f"입금 실패: {reason}")
        print("계좌 정보를 확인하고 support@onda.me로 연락주세요.")

세금계산서

자동 발행#

수수료에 대한 세금계산서는 정산 확정 시점에 자동으로 발행됩니다.

세금계산서 내역#

공급자: ONDA (주식회사 온다)

• 사업자등록번호: 123-45-67890
• 주소: 서울특별시 강남구 테헤란로 123

공급받는자: 귀사 정보 (등록된 사업자 정보)

품목 및 금액:

[2026년 2월 1일 정산 - 1.16~1.31 기간]

품목: ONDA API 플랫폼 수수료
수량: 150건
단가: 22,500원 (평균)
공급가액: 3,375,000원
부가세 (10%): 337,500원
총 합계: 3,712,500원

세금계산서 조회#

# API로 세금계산서 목록 조회
response = requests.get(
    "https://api.onda.me/v1/tax-invoices",
    headers=headers,
    params={
        "year": 2026,
        "month": 2
    }
)

invoices = response.json()

for invoice in invoices["data"]:
    print(f"발행일: {invoice['issue_date']}")
    print(f"공급가액: {invoice['supply_amount']:,}원")
    print(f"부가세: {invoice['tax_amount']:,}원")
    print(f"합계: {invoice['total_amount']:,}원")
    print(f"PDF: {invoice['pdf_url']}")
    print("---")

계좌 정보 관리#

계좌 등록 및 변경#

정산금을 입금받을 계좌 정보는 대시보드에서 관리할 수 있습니다.

경로: 대시보드 > 설정 > 정산 계좌

필수 정보:

• 은행명
• 예금주명 (사업자명과 일치 필요)
• 계좌번호
• 사업자등록번호 (법인 계좌의 경우)

계좌 변경 시점:

• 다음 정산부터 새 계좌로 입금 처리
• 진행 중인 정산은 기존 계좌로 입금

API로 계좌 정보 업데이트#

# 계좌 정보 변경
response = requests.put(
    "https://api.onda.me/v1/channels/me/bank-account",
    headers=headers,
    json={
        "bank_code": "088",           # 신한은행
        "account_number": "1234567890",
        "account_holder": "주식회사 예시",
        "business_number": "123-45-67890"
    }
)

if response.status_code == 200:
    print("계좌 정보 변경 완료")
    account = response.json()
    print(f"다음 정산부터 {account['bank_name']} {account['account_number']}로 입금됩니다.")

정산 관련 주의사항#

1. 최소 정산 금액#

정산 금액이 10,000원 미만인 경우, 다음 정산 주기로 이월됩니다.

# 정산 이월 예시
settlement_1 = {
    "date": "2026-02-01",
    "amount": 8500,
    "status": "carried_forward"  # 이월
}

settlement_2 = {
    "date": "2026-02-16",
    "amount": 150000,
    "carried_forward": 8500,      # 이월분 합산
    "total_payout": 158500,       # 실제 입금 금액
    "status": "completed"
}

2. 입금 실패 처리#

계좌 정보 오류 등으로 입금이 실패하면 이메일로 안내됩니다.

입금 실패 사유:

• 계좌번호 오류
• 예금주명 불일치
• 폐쇄된 계좌
• 은행 시스템 오류

해결 방법:

1. 계좌 정보 확인 및 수정
2. support@onda.me로 재입금 요청
3. 영업일 기준 2~3일 이내 재처리

3. 환불 처리#

예약 취소로 고객에게 환불이 발생하면, 정산 금액에서 차감됩니다.

# 환불 발생 시 정산 조정
original_settlement = {
    "gross_revenue": 1000000,
    "commission": 150000,
    "net_payout": 850000
}

# 예약 취소 (전액 환불)
refund = {
    "reservation_total": 154000,
    "commission_refund": 23100,
    "payout_deduction": 130900
}

adjusted_settlement = {
    "gross_revenue": 1000000 - 154000,  # 846,000원
    "commission": 150000 - 23100,        # 126,900원
    "net_payout": 850000 - 130900,       # 719,100원
    "refund_adjustments": [refund]
}

4. 노쇼 (No-show) 처리#

고객이 체크인하지 않은 경우(노쇼), 숙박 시설 정책에 따라 정산 처리됩니다.

Enterprise 등급 주간 정산#

Enterprise 등급은 주 1회 정산을 선택할 수 있습니다.

주간 정산 일정#

2월 주간 정산 예시:

1주차 정산 (2월 7일 금요일)
  집계 기간: 2월 1일 (토) ~ 2월 7일 (금) 체크아웃
  입금 예정: 2월 12일 (수)

2주차 정산 (2월 14일 금요일)
  집계 기간: 2월 8일 (토) ~ 2월 14일 (금) 체크아웃
  입금 예정: 2월 19일 (수)

3주차 정산 (2월 21일 금요일)
  집계 기간: 2월 15일 (토) ~ 2월 21일 (금) 체크아웃
  입금 예정: 2월 26일 (수)

4주차 정산 (2월 28일 금요일)
  집계 기간: 2월 22일 (토) ~ 2월 28일 (금) 체크아웃
  입금 예정: 3월 5일 (수)

정산 관련 FAQ#

1. 정산 금액이 예상과 다릅니다.#

다음 사항을 확인해주세요:

• 환불 조정 발생 여부
• 수수료율 (등급 변경 여부)
• 최소 정산 금액 이월 (10,000원 미만)
• 세금계산서 상의 공급가액과 비교

2. 입금 예정일이 지났는데 입금이 안 됐습니다.#

입금은 은행 영업일 기준으로 처리됩니다. 공휴일이나 주말이 포함되면 지연될 수 있습니다. 영업일 기준 5일이 지나도 입금이 안 되면 support@onda.me로 문의해주세요.

3. 세금계산서를 받지 못했습니다.#

대시보드의 정산 관리 > 세금계산서 메뉴에서 직접 다운로드할 수 있습니다. 이메일 미수신은 스팸 메일함을 확인하거나 담당자에게 이메일 주소 변경을 요청해주세요.

4. 정산 주기를 변경할 수 있나요?#

Enterprise 등급만 주간 정산을 선택할 수 있습니다. Standard/Professional 등급은 월 2회 정산만 가능합니다.

5. 해외 송금이 가능한가요?#

현재는 국내 은행 계좌로만 정산이 가능합니다. 해외 송금이 필요하신 경우 enterprise@onda.me로 별도 문의해주세요.

다음 단계#

• 수수료 안내 - 수수료 구조 및 계산 방식
• 채널 등급 - 등급별 정산 주기 비교
• 대시보드 - 정산 내역 실시간 확인