객체

티켓타코 개발자도구에서 사용하는 객체 정보를 살펴보세요.

Order 객체

예매 정보를 담고 있는 객체입니다. 예매 한 건의 상태, 예매자, 결제 시간 등을 자세히 알 수 있습니다. 하나의 Order에는 하나 이상의 Ticket이 포함됩니다.

객체 상세

orderNumber string
예매 고유 번호입니다.

eventId string
예매한 이벤트의 고유 식별자입니다.

name string
예매한 이벤트의 이름입니다.

quantity number
예매에 포함된 티켓 수량입니다.

totalAmount number
총 결제 금액입니다. 단위는 원(KRW)입니다. 티켓이 취소되는 등 상태가 변해도 최초에 결제된 결제 금액으로 유지됩니다.

tickets Ticket[]
예매에 포함된 Ticket 객체 배열입니다.

purchaser User
예매자의 User 객체입니다.

status string
예매 상태입니다. 아래와 같은 상태 값을 가질 수 있습니다.

PAID: 결제가 완료된 상태입니다.
CANCELED: 예매에 포함된 모든 티켓이 취소된 상태입니다.

paidAt nullable string
결제를 완료한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

Ticket 객체

티켓 정보를 담고 있는 객체입니다. 개별 티켓의 상태, 소유자, 체크인 시간 등을 자세히 알 수 있습니다.

객체 상세

orderTicketNumber string
티켓 고유 번호입니다.

orderNumber string
티켓이 속한 예매의 고유 번호입니다.

eventId string
예매한 이벤트의 고유 식별자입니다.

ticketTypeName string
티켓 종류의 이름입니다. 예: “일반 참가권”, “VIP 참가권”

ticketTypePrice number
티켓 종류의 정가입니다. 단위는 원(KRW)입니다.

chargedAmount number
실제 결제 금액입니다. 단위는 원(KRW)입니다.

purchaser User
예매자의 User 객체입니다.

owner User
소유자의 User 객체입니다. 티켓을 양도하면 예매자와 다를 수 있습니다.

attendee nullable User
참가자의 User 객체입니다.

status string
티켓 상태입니다. 아래와 같은 상태 값을 가질 수 있습니다.

PAID: 결제가 완료된 상태입니다.
USED: 체크인하여 티켓이 사용된 상태입니다.
CANCELED: 티켓이 취소된 상태입니다.

paidAt nullable string
결제를 완료한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

usedAt nullable string
체크인한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

canceledAt nullable string
취소한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

Entry 객체

참가신청 정보를 담고 있는 객체입니다. 추첨·승인 방식 티켓의 신청 상태, 신청자, 결과 시간 등을 자세히 알 수 있습니다.

객체 상세

entryNumber string
참가신청 고유 번호입니다.

eventId string
신청한 이벤트의 고유 식별자입니다.

name string
신청한 이벤트의 이름입니다.

ticketTypeName string
티켓 종류의 이름입니다. 예: “일반 참가권”, “VIP 참가권”

ticketTypePrice number
티켓 종류의 정가입니다. 단위는 원(KRW)입니다.

quantity number
신청한 티켓 수량입니다.

totalAmount number
총 결제 금액입니다. 단위는 원(KRW)입니다. 신청이 취소되는 등 상태가 변해도 최초에 결제된 결제 금액으로 유지됩니다.

applicant User
신청자의 User 객체입니다.

saleMethod string
티켓 판매 방식입니다.

LOTTERY: 추첨 방식입니다.
APPROVAL: 승인 방식입니다.

status string
참가신청 상태입니다. 아래와 같은 상태 값을 가질 수 있습니다.

PENDING: 신청이 접수되어 결과를 대기 중인 상태입니다.
APPROVED: 추첨에 당첨되거나 승인된 상태입니다.
REJECTED: 추첨에 미당첨되거나 미승인된 상태입니다.
AWAITING_PAYMENT: 선정되어 결제를 대기 중인 상태입니다.
PAYMENT_EXPIRED: 결제 기한이 초과되어 만료된 상태입니다.
PAID: 결제가 완료된 상태입니다.
CANCELED: 신청이 취소된 상태입니다.

resultAt nullable string
추첨·승인 결과가 발표되는 날짜와 시간입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

paymentDue nullable string
선정된 참가신청의 결제 기한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

paidAt nullable string
결제를 완료한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

canceledAt nullable string
취소한 날짜와 시간 정보입니다. yyyy-MM-dd'T'HH:mm:ss.SSSZ ISO 8601 형식이며, UTC 기준입니다.

User 객체

사용자 정보를 담고 있는 객체입니다.

객체 상세

name nullable string
사용자 이름입니다.

phone nullable string
사용자 전화번호입니다.

email nullable string
사용자 이메일 주소입니다.