Skip to content
/bounty
Sign in
All bounties

Megabox

Open
megabox.co.kr

Unofficial browser-based cinema booking for Megabox.

Reward
₩300,000
Tier
Gold
Auth
Browser
APIs
6 APIs
Working now
none
Posted
2026-07-07
Kind
New service
Lifecycle
  1. Open
  2. Claimed
  3. In review
  4. Finalizing
  5. Syncing
  6. Merged
  7. Paid

Scope

Build a browser-facing provider for Megabox. It should cover showtime discovery, seat-map review, purchase preparation, coupon or membership application, explicit purchase confirmation, and post-booking ticket retrieval. The surface is login-gated and may involve session state, anti-bot controls, and branch-specific availability.

Expected APIs

6
search-movies-theaters-showtimesSearch movies, theaters, and showtimesReadMedium

Query the cinema catalog for movies, theaters, and screening times for a chosen date and region. This is a discovery step that returns the screenings a user can drill into before selecting seats.

Inputs
  • querystringOptionalMovie title or keyword to narrow the listing.Example 파묘
  • citystringOptionalCity or district used to filter nearby theaters.Example 서울
  • datedateRequiredScreening date to search.Example 2026-07-10
Outputs
movie_titletheater_namescreening_timeauditoriumremaining_seats
Acceptance
  • Returns multiple screenings for the requested date with theater and start-time details.
  • Filters correctly by movie keyword or cinema chain when those inputs are provided.
  • Does not imply seat availability beyond the remaining_seats or similar screening-level fields.

Must work without account auth.

get-screening-seat-map-pricesGet screening detail, seat map, and ticket pricesReadHard

Open one screening and retrieve the auditorium layout, seat classes, and price breakdown for the chosen showtime. The result should let a user judge where seats are available and what each seat or section costs before reserving anything.

Inputs
  • screening_idstringRequiredIdentifier for the chosen screening or showtime.Example SCN-20260710-1530-01
  • theater_idstringRequiredTheater or branch identifier paired with the screening.Example MB-0012
  • ticket_countnumberOptionalOptional number of tickets to preview pricing for.Example 2
Outputs
seat_mapseat_rowsseat_statusticket_pricesdiscount_rules
Acceptance
  • Returns a seat map or seat-status structure for the chosen screening.
  • Includes a price breakdown that distinguishes base fare from any seat-class or special-screen surcharge.
  • Requires an authenticated session and fails cleanly when the screening cannot be opened.

Auth required for this API.

prepare-seat-selection-ticket-quantityPrepare seat selection and ticket quantityWriteHard

Reserve the intended seat choices in a pre-checkout state and validate ticket quantity limits for the selected audience mix. This step should surface any seat conflicts, per-person constraints, or auditorium rules before the user commits to payment.

Inputs
  • screening_idstringRequiredScreening identifier from the selected showtime.Example SCN-20260710-1530-01
  • seat_idsarrayRequiredArray of seat identifiers the user wants to hold or select.Example ["A12","A13"]
  • ticket_countnumberRequiredNumber of tickets to reserve for the selected seats.Example 2
  • audience_typestringOptionalOptional audience category such as adult, youth, or senior used by some chains for pricing or constraints.Example adult
Outputs
reserved_seatshold_expires_atticket_countvalidation_errors
Acceptance
  • Rejects seat combinations that are already taken or violate auditorium rules.
  • Returns the temporary hold window or reservation expiry for the selected seats.
  • Preserves the requested ticket count and exposes validation errors when the request is not bookable.

Auth required for this API.

apply-coupons-membership-benefitsApply available coupons or membership benefitsWriteMedium

Check and apply cinema coupons, points, or membership discounts to the current booking draft. The operation should show the adjusted price and any constraints such as minimum spend, one-time-use limits, or chain-specific exclusions.

Inputs
  • booking_draft_idstringRequiredIdentifier for the active booking draft or cart.Example BOOK-88421
  • coupon_codestringOptionalCoupon or promo code to apply if available.Example MEMBER10
  • membership_idstringOptionalOptional membership or points account used for discounts.Example MB-MEMBER-12345
Outputs
applied_discountsfinal_amountcoupon_statusmembership_benefit
Acceptance
  • Applies only discounts the account is actually eligible to use.
  • Returns the revised payable amount after discounts and points are accounted for.
  • Explains why a coupon or benefit was rejected when it cannot be applied.

Auth required for this API.

confirm-ticket-purchaseConfirm ticket purchase only after explicit user approvalWriteHard

Submit the final cinema booking after the user explicitly approves the exact seats, price, and payment terms. This is the irreversible checkout step and should not run without a clear confirmation gate.

Inputs
  • booking_draft_idstringRequiredActive draft containing the chosen seats and price preview.Example BOOK-88421
  • payment_method_idstringRequiredSelected payment instrument or wallet reference.Example CARD-1
  • user_confirmationbooleanRequiredExplicit approval from the user to finalize the purchase.Example true
Outputs
booking_idpayment_statusticket_countissued_atreceipt_number
Acceptance
  • Requires explicit positive confirmation before any purchase is submitted.
  • Returns a booking or receipt identifier when checkout succeeds.
  • Fails safely if payment authorization or seat locking has expired.

Auth required for this API.

list-tickets-qr-cancellationList tickets, QR codes, and cancellation eligibilityReadMedium

Fetch issued ticket records for upcoming or past bookings, including QR or barcode data and whether each ticket can still be canceled. This is the post-purchase management step for finding the actual ticket artifact and its current cancellation state.

Inputs
  • booking_idstringOptionalOptional booking identifier to narrow the results to a single purchase.Example BOOK-88421
  • date_rangeobjectOptionalOptional start and end dates for filtering ticket history.Example {"from":"2026-07-01","to":"2026-07-31"}
Outputs
booking_idqr_codescreening_timetheater_namecancellable
Acceptance
  • Returns ticket artifacts for purchased bookings, including a scannable code or equivalent token.
  • Clearly exposes whether each booking is still eligible for cancellation.
  • Supports narrowing the result set by booking or date range without losing ticket status fields.

Auth required for this API.

Suggested surface. Propose changes in your submission if the upstream differs.

Acceptance criteria

  • Service scaffolded from the public @apifuse/provider-sdk
  • All listed APIs implemented with Zod/Standard Schema input & output
  • Each API declares exactly one of healthCheck or healthCheckUnsupported
  • Real upstream fixture data included where applicable
  • bun run check and bun run test pass
  • Auth, credential and env-secret behavior documented. No real secrets committed

Evidence to submit

  • Workspace repository and main commit link
  • SDK version/tag and the create command used
  • API list with input/output summaries
  • healthCheck coverage table per API
  • bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace is prepared after confirmation.