이해하기

결제창은 브라우저에서 띄워야 하며 프론트엔드 SDK 통해 연동해야 해요. 백엔드 방식으로 결제창을 띄우는 방법은 지원하지 않아요. 결제 진행 순서는 아래와 같아요.

결제창 방식보다는결제위젯을 권장해요. 결제위젯은 나이스페이, KCP, 라이트페이만 지원되며, 주문서 페이지에서 PG 결제창 없이 바로 카드사 결제창을 띄울 수 있어요.

주문서 페이지

가맹점에서 제공하는 페이지로, 고객이 결제할 상품 정보를 후 결제하기 버튼을 누르는 페이지에요.

부트페이 위젯은 주문서 페이지에 적용되어야 합니다. 위젯이란 결제 수단을 선택하는 UI로 구매자 혜택, 할인 정보를 쉽게 보여줄 수 있어요.  귀찮더라도 한 번 연동해두시면, 나중에 PG사가 추가되거나 변경될 때도 코드를 바꾸지 않고 쉽게 반영할 수 있어요.  비개발자도 쉽게 운영할 수 있는 위젯을 추천드려요.

결제창 띄우기

결제 요청 시 PG사에서 제공하는 결제창을 통해 고객이 결제를 진행합니다. 이 결제창은 안전하게 결제 정보를 입력하고 처리할 수 있는 환경을 제공해요.

결과 처리

승인 과정에 따라 이벤트가 전달되며, 가맹점은 이벤트에 따라 결제를 처리하고 고객에게 결과를 안내해야 해요.

인증 성공 confirm분리 승인 사용시 호출

인증이 완료되면 호출되는 이벤트입니다. 유효성 검사 후 승인하기 위해 사용됩니다.

승인 성공 done

결제 완료 이벤트가 전달됩니다. 결제 결과 페이지로 이동하여 고객에게 결제 결과를 안내해주세요.

승인 실패 error

결제 실패 이벤트가 전달됩니다. 결제 결과 페이지로 이동하여 고객에게 결제 결과를 안내해주세요.

사용자 취소 cancel

취소 이벤트가 전달됩니다. 고객이 결제창의 닫기 버튼을 눌러 결제를 취소한 경우에 해당합니다.

결제창 닫기 close

결제 결과에 상관없이 결제창이 닫히면 이벤트가 전달돼요. 기본적으로 제공되는 이벤트가 아니며, 필요시 활성화 할 수 있어요.

웹훅 통지

승인 성공시 결제 결과가 부트페이 서버 → 가맹점 서버로 전송돼요. 가맹점 서버에서 결제 결과를 저장해야 해요.

결제 결과 페이지

가맹점에서 제공하는 페이지로, 결제 결과를 고객에게 안내해야 해요. 주문 완료, 실패 내용을 고객에게 알려주어야 하며, 사용자 취소시에는 결과 페이지가 아닌 이전 주문서 페이지로 돌아가길 추천해요.