배달 운영과 체험단 모집을 한 화면에서 처리
- 상점 프로필, 영업시간, 휴무, 메뉴, 옵션, 품절 등록
- 캠페인별 식대 한도, 리뷰 리워드, 모집 인원 설정
- 주문 접수, 조리 시간 입력, 배달 호출, 문제 주문 기록
- 리뷰 승인 후 정산 대기액과 완료액 확인
배달앱 선구매 체험단을 판매자, 인플루언서, 총괄 관리자가 같은 상태값으로 운영하도록 설계한 A to Z 서비스 흐름입니다. 핵심 원칙은 인플루언서가 먼저 주문 결제하고, 영수증과 리뷰 증빙이 승인된 뒤 식대 환급과 리뷰 리워드를 정산하는 것입니다.
WithDelivery는 일반 배달 주문 중개가 아니라 음식점의 체험단 마케팅을 배달앱 주문 증빙과 연결하는 운영 시스템입니다. 판매자는 메뉴와 체험 예산을 등록하고, 인플루언서는 본인 결제로 주문한 뒤 사진 리뷰를 제출하며, 총괄 관리자는 증빙·분쟁·정산을 통제합니다.
이 문서는 WithDelivery 운영 workflow spec의 canonical 문서입니다. Repository 구현과 production route smoke가 존재해도 delivery provider live integration, payout provider, finance approval, real role-session evidence가 없으면 live-complete로 판정하지 않습니다.
| 영역 | 현재 상태 | 판정 기준 |
|---|---|---|
| Repository implementation | covered | Owner console, influencer tracking/review, admin arbitration, guide 문서가 repository-level evidence로 존재합니다. |
| Production route smoke | covered / latest evidence required | /withdelivery, /guide/withdelivery, /withdelivery/guide, /withdelivery-workflow.html, /withdelivery/partner, /withdelivery/track/test, /admin/operations를 read-only로 확인해야 합니다. |
| Owner console | covered | 주문 접수, 거절, 조리, 배달 출발, 문제 주문, campaign/applicant/insight 패널이 확인 대상입니다. |
| Influencer tracking/review | covered | 선구매 증빙, 수령 확인, 리뷰 URL, 음식 사진, 정산 계좌 체크리스트가 확인 대상입니다. |
| Admin arbitration | covered | 수동 승인, 지급대기, 지급완료, 패널티, 강제취소, payout readiness panel이 확인 대상입니다. |
| Delivery provider live integration | blocked | 현재 tracking mode는 internal_status_fallback입니다. provider_live로 표시하려면 provider contract, schema confirmation, secret readiness, redacted payload evidence가 필요합니다. |
| Payout provider onboarding/contracts | blocked | provider onboarding package, GSM/Cloudflare secret readiness, finance/live approval, first live transfer authorization이 모두 필요합니다. |
| Real owner/influencer/admin sessions | blocked | raw auth key/cookie/session value 없이 role-session package와 authenticated real-data UI audit evidence가 필요합니다. |
배달의민족과 쿠팡이츠의 판매자 운영 기능은 주문 접수, 매장 상태, 배달 파트너, 리뷰, 정산으로 압축됩니다. WithDelivery는 이 구조를 그대로 복제하지 않고 체험단 마케팅 증빙, 선구매 검증, 후정산 승인 구조로 재배치합니다.
| 벤치마크 기능 | 참고 포인트 | WithDelivery 적용안 | 차별점 |
|---|---|---|---|
| 주문접수/POS | 주문 수신 후 수락, 조리, 전달까지 사장님 기기에서 처리 | 접수 대기, 조리중, 배달 호출, 완료, 문제 발생을 캠페인 주문 큐로 통합 | 일반 주문 매출보다 체험단 증빙과 정산 상태가 우선 |
| 매장 운영 | 메뉴, 옵션, 품절, 영업시간, 휴무를 운영자가 직접 관리 | 상점 프로필과 메뉴 정보가 캠페인 등록 조건과 자동 연결 | 품절·휴무 상태는 인플루언서 지원 가능 여부와 즉시 연결 |
| 배달 파트너 | 배달 파트너 배정, 픽업, 배달 완료가 주문 상태를 움직임 | 배민, 쿠팡이츠, 수동, 매장 라이더 등 호출 채널과 ETA를 기록 | 외부 배달앱 주문번호와 WithDelivery 내부 주문을 이중 매칭 |
| 리뷰 정책 | 부적합 리뷰, 게시중단, 블라인드, 이의제기 기준 존재 | 리뷰 URL, 음식 사진, 영수증, 미션 문구를 관리자 검수 대상으로 저장 | 마케팅 성과 증빙과 분쟁 대응 자료를 함께 보관 |
| 정산/수수료 | 주문금액, 배달비, 결제대행 수수료, 부분 취소에 따른 재정산 구조 | 식대 환급, 배달비 인정 여부, 리뷰 리워드, 국가별 세금·KYC를 분리 계산 | 정산 실행 전 명시적 승인과 증빙 완성도를 필수 게이트로 둠 |
외식업주는 배달앱 운영처럼 빠르게 주문을 처리하되, 모든 주문은 체험단 캠페인과 정산 증빙에 연결됩니다.
참여자는 “지원 → 선정 → 직접 주문 → 증빙 제출 → 리뷰 업로드 → 정산 수령” 순서로 움직입니다. 모든 단계는 모바일에서도 한 손으로 진행 가능한 체크리스트 구조가 되어야 합니다.
총괄 관리자는 매장 품질, 캠페인 안전성, 리뷰 신뢰성, 글로벌 정산 리스크를 통제합니다. 관리 화면은 승인 큐, 분쟁 큐, 지표 큐, 정산 큐가 분리되어야 합니다.
| 관리 영역 | 주요 판단 | 필수 화면 | 차단 조건 |
|---|---|---|---|
| 상점 승인 | 사업자 정보, 영업 주소, 메뉴 적합성, 배달 가능 시간 확인 | 상점 승인 큐, 증빙 미리보기, 위험 태그 | 주소 불일치, 메뉴 누락, 연락처 불명, 운영 시간 미입력 |
| 캠페인 승인 | 식대 한도, 리워드, 모집 인원, 리뷰 조건의 과장 여부 확인 | 캠페인 심사 보드, 예산 계산기, 미션 문구 검사 | 불명확한 리뷰 의무, 예산 부족, 과도한 보상 약속 |
| 분쟁 중재 | 오배달, 누락, 품질 불만, 리뷰 거절, 정산 보류 사유 판단 | 증빙 타임라인, 메시지 로그, 상태 변경 이력 | 증빙 위조 의심, 중복 영수증, 주문번호 불일치 |
| 유저 통계 | 판매자별 주문 전환, 인플루언서 승인율, 리뷰 완료율 확인 | 역할별 대시보드, 국가·통화 필터, 캠페인 퍼널 | 반복 취소, 반복 분쟁, 비정상 리뷰 패턴 |
| 글로벌 정산 | 국가, 통화, 환율 잠금, 세금 거주지, KYC, 지급 수단 확인 | 정산 승인 큐, 환율 잠금 패널, 지급 실행 로그 | 환율 미잠금, KYC 미확인, 지급 승인 부재, 공급자 스키마 미확인 |
화면과 API가 같은 상태값을 사용해야 분쟁과 정산에서 증빙 누락을 줄일 수 있습니다.
| 배달 edge case | 상태값 | 운영 처리 |
|---|---|---|
| 주문 조회 실패 | order_not_found | 보완 요청 또는 수동 중재 |
| 주문 금액 불일치 | order_amount_mismatch | review_pending 또는 dispute로 보류 |
| 중복 주문번호 | duplicate_order_reference | 승인 차단과 감사 로그 기록 |
| 상점/고객 취소 | store_rejected_order / order_cancelled_by_store / order_cancelled_by_customer | 환불 또는 정산 제외 |
| 조리·픽업·배달 지연 | cooking_delayed / pickup_delayed / delivery_delayed | ETA 재안내와 중재 큐 이동 |
| 배달 실패 또는 주소 오류 | delivery_failed / wrong_address | 환불 검토와 정산 보류 |
| 오배송·누락·품질 분쟁 | wrong_item_delivered / missing_item / food_quality_dispute | 증빙 타임라인 기반 관리자 중재 |
| 환불 또는 부분 환불 | refund_requested / partial_refund_requested / refund_completed | 정산 재계산과 회수 후보 등록 |
| 리뷰 삭제·비공개·URL 오류 | review_deleted / review_private / review_url_invalid | 보완 요청, settlement_hold, settlement_recovered |
| 수동 중재 | manual_arbitration / settlement_hold / settlement_recovered | actorId, actorRole, action, reasonCode, memo, previousStatus, nextStatus, createdAt, relatedOrderId, relatedCampaignId, relatedSettlementId, metadata 필수 |
| 데이터 묶음 | 필수 필드 | 검증 규칙 |
|---|---|---|
| 상점 | storeId, name, countryCode, timezone, currency, phone, address, acceptingOrders | 국가 2자리, 통화 3자리, 주소와 배달 가능 여부 필수 |
| 캠페인 | campaignId, deliveryApp, foodBudget, rewardPerInfluencer, participants, missionRequirement | 식대·리워드·인원은 0보다 커야 하며, 선구매 필수 플래그 고정 |
| 주문 증빙 | orderReference, receiptUrl, paidAmount, deliveryFee, orderedAt, deliveryTracking | 주문번호와 영수증 중복 검사, 결제 금액과 식대 한도 비교 |
| 리뷰 증빙 | foodPhoto, reviewUrl, reviewPublishedAt, platform, missionChecklist | URL 접근성, 사진 수량, 미션 키워드, 공개 상태 확인 |
| 정산 | payoutAccount, taxResidency, kycConfirmation, payoutCurrency, lockedFxRate | 원문 계좌 저장 금지, 환율 잠금 전 외화 지급 차단 |
정산은 “환급 대상 식대 + 리뷰 리워드 + 인정 배달비 - 차감/보류”로 계산하되, 글로벌 지급은 별도의 승인 조건을 만족해야 합니다.
피크타임 주문 폭주 또는 재고 소진 시 점주 POS의 접수 상태 토글을 끄고, 참여자 화면에서는 준비 중 매장으로 블라인드합니다.
점주가 주문을 거절하면 취소 이벤트와 위드캐시 환불 원장을 같은 요청에서 기록해 참여자 지갑에 즉시 반영합니다.
점주가 POS에서 배달 출발을 누르면 인플루언서 주문 이력은 WebSocket 또는 Polling 경로로 배달 중 상태를 갱신합니다.
order_received, cooking, ready_for_pickup, picked_up, in_delivery, delivered, delivery_failed 상태는 내부 이벤트로 동작합니다. 외부 provider 연결 시 providerName, externalOrderId, externalTrackingId, lastProviderStatus, lastSyncedAt, syncError만 분리 저장하고 providerPayloadRedacted만 보관합니다.
| 상황 | 사용자 경험 | 관리자 처리 | 정산 영향 |
|---|---|---|---|
| 피크타임 또는 재고 소진 | 참여자에게 준비 중 상태와 대체 가능 시간을 표시 | 점주 콘솔에서 체험단 주문 접수 임시 중지 토글과 사유 기록 | 신규 선구매 예약을 차단하고 기존 확정 건만 추적 |
| 주문 거절 | 참여자에게 거절 사유, 재주문 가능 여부, 환불 완료 상태 표시 | 거절 사유와 재시도 허용 여부를 기록하고 취소 이벤트를 생성 | 선결제 위드캐시 포인트와 결제 대금을 같은 요청에서 자동 환불 |
| 배달 실패 | 문제 신고, 사진/채팅 증빙 추가 제출 | 판매자 귀책, 배달 채널 귀책, 참여자 귀책 분리 | 귀책 판단 후 환급 보류 또는 승인 |
| 영수증 중복 | 재제출 안내와 자동 중복 경고 | 주문번호, 금액, 시간, 이미지 해시 비교 | 중복 해소 전 지급 차단 |
| 리뷰 삭제 | 복구 또는 대체 URL 제출 요청 | 삭제 시점, 플랫폼 정책, 스크린샷 증빙 확인 | 리뷰 리워드 보류, 식대는 사안별 분리 판단 |
| 외화 지급 | 예상 지급액과 환율 기준일 표시 | 환율 잠금, 수취 국가, 지급 레일 확인 | 환율 미잠금이면 지급 실행 차단 |
아래 자료는 주문접수, 매장 운영, 배달 파트너, 리뷰, 정산 정책을 벤치마킹하기 위해 확인한 공개 자료입니다.