정산 가이드

ONDA 플랫폼의 송금 기반 정산 프로세스와 보증금 관리를 안내합니다.

ONDA Platform Engineering 관리

정산 가이드

ONDA API를 통해 발생한 예약에 대한 정산 프로세스, 보증금 관리, 세금계산서 안내입니다.

정산 모델 개요

ONDA는 송금 기반 정산 모델을 사용합니다. 보증금은 결제 수단이 아니라 이행 담보입니다.

예약 확정 시: 입금가만큼 보증금 잔액이 홀드됩니다 (차감 아님)
체크아웃 후: 해당 예약이 주간 정산 배치에 편입됩니다
채널 → ONDA 송금: 채널이 정산 금액(입금가 합계)을 ONDA에 송금합니다
송금 확인 시: 홀드가 해제되어 보증금이 원복됩니다
기한 내 미입금 시: 보증금에서 해당 금액이 영구 차감됩니다

정상적으로 송금이 이루어지는 한 보증금은 줄어들지 않습니다. 보증금 차감은 송금 기한(D+3)을 넘긴 경우에만 발생합니다.

정산 프로세스 (주간 사이클)

체크아웃 완료

체크아웃이 지난 예약은 매일 새벽 배치에서 정산 대상(checked_out)으로 전환되고, 해당 주의 송금 배치에 편입됩니다.

정산일 (매주 월요일)

전주 월요일~일요일 체크아웃분이 하나의 송금 배치로 확정됩니다. 정산일은 체크아웃 주의 다음 주 월요일입니다.

채널 송금 (D+3 이내)

채널은 정산일로부터 3영업일(D+3) 이내에 배치 금액(입금가 합계)을 ONDA에 송금합니다. D+1, D+2에 미입금 리마인더가 발송됩니다.

송금 확인 → 홀드 해제

ONDA가 입금을 확인하면 해당 배치의 예약 홀드가 해제되어 보증금 가용 잔액이 원복됩니다.

D+3 미입금 시

정산일 + 3영업일까지 송금이 확인되지 않으면 해당 배치 금액이 보증금에서 영구 차감됩니다. 보증금이 줄어들면 가용 잔액이 감소하여 신규 예약이 제한될 수 있으므로, 송금 기한을 반드시 지켜주세요.

시점	처리
정산일 (월요일)	송금 배치 확정, 송금 안내
D+1, D+2 (영업일)	미입금 리마인더
D+3 (영업일) 경과	보증금에서 영구 차감

정산 기준

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

예약 상태	정산 포함 여부
`confirmed`	❌ (체크아웃 대기, 잔액 홀드 유지)
`checked_out`	✅ 정산 대상 (주간 송금 배치 편입)
`cancelled`	❌ (취소 — 환불 정책에 따라 홀드 해제/조정)
`no_show`	✅ 정산 대상

보증금 및 잔액 흐름

1. 보증금 충전

# 충전 요청 (최소 ₩500,000, ₩100,000 단위)
balance = {
    "currency": "KRW",
    "charged": 500000,   # 충전액
    "available": 500000  # 가용 잔액
}

가상계좌 발급 수수료(건당 ₩400)는 ONDA가 부담합니다.

2. 예약 확정 (잔액 홀드)

예약 시점에 입금가만큼 가용 잔액이 홀드됩니다. 가용 잔액이 예약 입금가보다 적으면 402 INSUFFICIENT_BALANCE가 반환됩니다.

# 예약 시 입금가만큼 잔액 홀드
booking = {
    "netAmount": "154000",  # 입금가 (보증금 홀드 금액)
    "currency": "KRW",
}
# 가용 잔액 = 충전액 - 홀드 합계

3. 체크아웃 → 송금 → 홀드 해제

체크아웃(예: 수요일)
  → 다음 주 월요일 = 정산일 (배치 확정)
  → 채널이 입금가 합계 송금 (D+3 이내)
  → ONDA 입금 확인 → 홀드 해제 (보증금 원복)

수수료

수수료는 예약 입금가의 5% 단일 수수료입니다 (등급 무관, 호출당 과금 없음). 예약 대금은 위의 주간 송금 흐름으로 실시간 정산되며, 월간 명세서는 수수료 청구서입니다:

월 청구액(수수료) = 해당 월 체크아웃 완료 거래액 × 5%

환불·위약금은 명세서에 별도 항목으로 표기되며, 잔액 충전액은 정산 항목이 아닙니다.

자세한 내용은 수수료 안내를 참고하세요.

정산 내역 확인

정산 내역 조회는 개발자 포털 대시보드에서 제공됩니다. Channel API에는 정산 조회 엔드포인트가 없습니다.

경로: 대시보드 > Settlement

확인 가능한 정보:

현재 가용 잔액 및 홀드 금액
충전 내역
예약별 입금가 및 수수료
송금 배치별 정산 상태
환불 조정 내역

잔액은 통화별로 독립적으로 관리됩니다. KRW와 USD 잔액은 별도로 홀드·정산되며, 통화 간 자동 전환은 지원하지 않습니다.

세금계산서

수수료에 대한 세금계산서는 월 정산 확정 시 생성되며, 개발자 포털 대시보드에서 확인할 수 있습니다.

항목	내용
생성 시점	월 정산 확정 시
공급가액	수수료 (부가세 별도)
부가세	공급가액의 10%
확인 방법	대시보드 > Settlement

Channel API의 GET /tax-invoices 엔드포인트는 아직 제공되지 않습니다 (501 NOT_IMPLEMENTED, 추후 제공 예정).

보증금 충전 및 환불

충전

경로: 대시보드 > Billing > 충전

충전 요청 (최소 ₩500,000, ₩100,000 단위)
발급된 가상계좌로 입금하면 잔액에 즉시 반영
가상계좌 발급 수수료(건당 ₩400)는 ONDA가 부담

환불

충전한 보증금은 해지 시 미정산 금액(미송금 배치, 수수료 등)을 차감한 후 잔액 전액이 환불됩니다.

잔액 부족 주의

가용 잔액(충전액 − 홀드 합계)이 예약 입금가보다 적으면 운영 환경의 예약이 차단되며 INSUFFICIENT_BALANCE 오류가 반환됩니다. 체크아웃 후 송금 확인 전까지는 홀드가 유지되므로, 예약 규모에 맞는 보증금을 유지하세요.

정산 관련 주의사항

1. 환불 처리

예약 취소로 고객 환불이 발생하면 취소 정책에 따라 홀드가 해제/조정되고, 해당 예약의 수수료도 환불액에 비례하여 조정됩니다.

2. 노쇼 (No-show) 처리

노쇼 예약(reservation.no_show 웹훅 발행)도 체크아웃분과 동일하게 주간 송금 배치에 포함되어 정산됩니다.

3. 통화별 잔액 관리

KRW와 USD 잔액은 독립적으로 관리됩니다. 송금 배치도 통화별로 분리됩니다.

정산 관련 FAQ

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

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

환불 조정 발생 여부
수수료(입금가의 5%) 적용 내역
홀드 중인 예약(체크아웃 대기 또는 송금 확인 대기) 금액

2. 보증금은 언제 차감되나요?

정상 흐름에서는 차감되지 않습니다. 정산일 + 3영업일(D+3)까지 송금이 확인되지 않은 경우에만 해당 배치 금액이 보증금에서 영구 차감됩니다.

3. 잔액이 부족하면 어떻게 되나요?

가용 잔액이 예약 입금가보다 적으면 운영 환경의 예약이 차단됩니다. Sandbox 환경은 영향 없이 계속 사용할 수 있습니다.

4. 충전한 보증금은 환불되나요?

네, 해지 시 미정산 금액을 차감한 후 잔액 전액이 환불됩니다.

5. 어떤 통화를 지원하나요?

현재 KRW(원화)와 USD(달러) 두 가지 통화를 지원합니다. 통화별 잔액은 독립적으로 관리됩니다.

다음 단계

수수료 안내 - 입금가의 5% 단일 수수료 구조
채널 등급 - 등급별 운영 조건
대시보드 - 정산 내역 실시간 확인