수동 승인

포트원을 통해 PG의 결제 UI를 표시하면, 구매자는 UI에서 정보 입력 및 인증을 진행합니다. 이 과정이 끝나고 UI가 닫히면 자동으로 결제 승인(또는 가상계좌 발급, 빌링키 발급)이 일어납니다.

그러나 채널 설정에서 수동 승인을 켜면, 결제 UI가 완료되더라도 고객사 서버에서 포트원의 수동 승인 API를 호출하지 않으면 결제 승인 등이 일어나지 않습니다.

수동 승인이 유용한 경우

• 결제 승인 전 마지막으로 재고 확인이 필요할 때
• 수량이 한정된 선착순 판매일 때
• 결제 완료 상태를 웹훅으로 수신하기보다, 직접 API를 호출해서 결제를 완료시키는 것을 선호할 때
• 수동 승인 방식으로 타 결제사를 연동한 상태에서 포트원도 같은 구조로 연동하고 싶을 때

자동 승인이 유용한 경우

• 수동 승인을 지원하지 않는 PG를 이용할 때
• 수동 승인을 지원하지 않는 PG를 추후 연동할 가능성이 높을 때 (특히, 위챗 등 다양한 해외 결제수단 연동을 고려하고 있을 때)
• 결제 완료 등 결제 상태를 웹훅으로 수신하는 데 불편함이 없을 때

인증 결제 수동 승인 이용 방법

채널 설정에서 수동 승인을 켭니다. 수동 승인 설정은 채널별로 적용됩니다.

수동 승인이 켜진 채널로 PortOne.requestPayment를 호출하면 응답에 paymentToken 필드가 포함됩니다. (수동 승인을 켜지 않은 채널이면 paymentToken 필드는 포함되지 않습니다.)

이렇게 UI 호출 응답으로 받은 paymentToken을 이용해 서버에서 인증 결제 수동 승인 API를 호출하면 결제가 승인됩니다. (가상계좌 발급 건의 경우 수동 승인 API 호출 시에 가상계좌가 발급됩니다.)

빌링키 발급 수동 승인 이용 방법

채널 설정에서 수동 승인을 켭니다. 수동 승인 설정은 채널별로 적용됩니다.

수동 승인이 켜진 채널로 PortOne.requestIssueBillingKey나 PortOne.requestIssueBillingKeyAndPay를 호출하면 응답에 billingIssueToken 필드가 포함됩니다. (수동 승인을 켜지 않은 채널이면 billingIssueToken 필드는 포함되지 않습니다.)

이때 빌링키는 아직 발급된 상태가 아닙니다. 따라서 응답으로 전달되는 billingKey 값은 NEEDS_CONFIRMATION입니다. requestIssueBillingKeyAndPay를 사용한 경우에는 txId 값 또한 NEEDS_CONFIRMATION으로 전달됩니다.

이렇게 UI 호출 응답으로 받은 billingIssueToken을 이용해 서버에서 포트원 API를 호출하면 빌링키가 발급됩니다. requestIssueBillingKeyAndPay의 경우 빌링키 발급과 함께 초회 결제도 일어납니다.

• requestIssueBillingKey의 경우 빌링키 발급 수동 승인 API를 호출합니다.
• requestIssueBillingKeyAndPay의 경우 빌링키 발급 및 초회 결제 수동 승인 API를 호출합니다.