컨펌 프로세스 (Confirm Process)

해당 서비스는 결제 승인 직전에 고객사에서 결제 의사를 최종적으로 확인하는 서비스입니다.

컨펌 프로세스 (Confirm Process)란?

• 결제 승인 직전 고객사에 결제 승인 요청 의사를 마지막으로 확인하는 서비스 입니다.

• 기본적인 결제 플로우상 고객사에서 결제 요청 후 별도의 확인 없이 결제 승인되는 구조입니다. 하지만 해당 서비스 이용 시 고객사가 최종적으로 결제 승인 요청의 주체가 될 수 있습니다.

해당 서비스가 반드시 필요한 고객사는 아래와 같은 경우입니다.

• 판매 제품의 재고가 소량으로 재고파악이 필요한 경우 (한정된 상품 또는 고가 제품 판매시)
• 선착순 방식으로 결제가 진행되어야 하는 경우
• 결제 승인 전 마지막으로 고객사에서 처리하고 싶은 로직이 존재하는 경우

컨펌 프로세스 (Confirm Process) 사용 케이스

판매 제품의 재고가 소량으로 재고파악이 필요한 경우

고객사의 판매 제품이 재고가 충분하지 않을 경우 구매자가 동시에 구매를 요청할 수 있기 때문에 결제 직전 고객사 서버에서 재고 수량을 한 번 더 확인하고 수량이 있는 경우에만 결제가 승인되도록 처리할 수 있습니다.
만약 컨펌 프로세스를 설정하지 않는 경우 실제 결제 승인 후 재고가 부족하여 제품 발송이 늦어지거나 주문을 취소 처리가 발생하여 고객의 결제 경험 만족도를 저하시키는 상황이 반복될 수 있습니다.

선착순 방식으로 결제가 진행되어야 하는 경우

마라톤 참가 신청, 인기 콘서트 티켓팅 또는 OO Day 같은 특별 할인 행사처럼 특정 시간에 매우 많은 고객이 동시에 결제 요청을 하는 경우 한정된 수량을 초과하지 않도록 고객사에서 최종적으로 수량을 확인한 후 결제가 승인되도록 처리할 수 있습니다.

결제 승인 전 마지막으로 고객사에서 처리하고 싶은 로직이 존재하는 경우

이밖에 다른 사유로 고객사에서 결제 승인 완료 직전 자체 업무 처리가 필요한 경우(결제 직전 고객사 서버 헬스체크 등) 해당 서비스를 이용할 수 있습니다.

컨펌 프로세스 (Confirm Process) 이용방법

컨펌 프로세스 이용시 고객사는 PortOne.requestPayment(), PortOne.loadPaymentUI() 함수 호출 시

confirmUrl 파라미터를 정의하고 해당 파라미터에 고객사 EndPoint URL을 설정합니다.

JavaScript SDK
{
  //...중략
  "confirmUrl": "고객사 EndPoint URL 기재",
  //...중략
}

해당 URL이 설정되면 포트원에서 결제 승인 요청 직전 해당 URL로 HTTP 통신이 진행되며 아래와 같은 데이터가 POST로 요청됩니다. (Timeout : 10s)

tx_id: 포트원 결제번호

payment_id: 고객사 주문번호

total_amount: 결제 요청 금액

해당 요청에 대한 고객사 응답으로 HTTP Status 200 응답인 경우에만 결제 승인을 요청합니다. 200 응답이 아닌 경우 결제가 진행되지 않으며 결제 실패 상태로 남습니다.