개요
Booking 서비스의 구매 도메인은 공개 구매 요청 생성, 조회, 결제 처리 기능을 제공합니다. MainPay 결제 게이트웨이와의 연동을 통한 온라인 결제를 지원합니다.Types
PublicPurchase
공개 구매 요청 객체MainPayPurchaseSignature
MainPay 결제 서명 정보Queries
getAccommodationPublicPurchases
숙박시설의 공개 구매 요청 목록을 페이지네이션하여 조회합니다.GraphQL Signature
파라미터
ID!
required
조회할 숙박시설 ID
Int
앞에서부터 가져올 항목 수 (forward pagination)
String
이 커서 이후의 항목들을 가져옴
Int
뒤에서부터 가져올 항목 수 (backward pagination)
String
이 커서 이전의 항목들을 가져옴
예제
getSinglePublicPurchase
단일 공개 구매 요청을 ID로 조회합니다.GraphQL Signature
파라미터
ID!
required
조회할 구매 요청 ID
getAccommodationPgConfig
숙박시설의 PG(결제 게이트웨이) 설정을 조회합니다.GraphQL Signature
파라미터
ID!
required
조회할 숙박시설 ID
Mutations
createPublicPurchaseRequest
새로운 공개 구매 요청을 생성합니다.GraphQL Signature
입력 파라미터
String!
required
날짜별 가격 정보 토큰
ID!
required
숙박시설 ID
ID!
required
객실 타입 ID
Date!
required
사용 시작일
Date!
required
사용 종료일
Int!
required
투숙 인원
Int!
required
추가 인원
String!
required
투숙객 이름
String!
required
투숙객 연락처
String!
required
객실 타입 이름
String
특별 요청사항
String
쿠폰 사용 해시
Int
할인 금액
예제
requestMainpayPurchaseReady
MainPay 결제를 준비하고 결제 서명을 발급합니다.GraphQL Signature
입력 파라미터
ID!
required
구매 요청 ID
Int!
required
결제 금액 (원)
String!
required
상품명
String!
required
구매자 이름
String!
required
구매자 연락처
String!
required
결제 완료 후 리다이렉션될 호스트 URL
응답
결제 페이지로 이동하기 위한 서명 정보를 반환합니다.String!
PC 결제 페이지 URL
String!
모바일 결제 페이지 URL
resolveMainpayPurchase
MainPay 결제 결과를 확인하고 처리합니다.GraphQL Signature
입력 파라미터
ID!
required
구매 요청 ID
String!
required
MainPay 인증 토큰
응답
Boolean!
결제 완료 여부
String!
결제 결과 코드
String
결제 결과 메시지
waitPublicPurchaseResolved
구매 요청이 완료될 때까지 대기하고 예약 객체를 반환합니다.GraphQL Signature
이 mutation은 결제 완료 후 예약이 생성될 때까지 대기하는 폴링 방식으로 동작합니다.
결제 흐름
- 구매 요청 생성:
createPublicPurchaseRequest - 결제 준비:
requestMainpayPurchaseReady로 결제 URL 획득 - 결제 진행: 반환된 URL로 사용자를 리다이렉션하여 MainPay 결제 진행
- 결제 완료:
resolveMainpayPurchase로 결제 결과 확인 - 예약 확인:
waitPublicPurchaseResolved로 생성된 예약 조회