포트원 결제 처리 정리

1. 유저가 결제 버튼을 누르면
2. 사전 검증을 위해 상품의 가격을 포트원에 알려준다
- ajx로 내 서버에 간 후 포트원으로 request를 2번 날린다
- 첫번째를 날려 token을 받고
- 두번째로 위 token과 함께 merchant_uid (서버에서 직접 생성한 주문 id), 가격을 함께 날려준다.
- order DB의 콜렉션을 새로 만들고 위에서 만든 merchant_uid를 저장한다.
- merchant_uid 를 클라로 리턴한다.

3. 다시 클라로 돌아온 후 IMP.request_pay()를 날린다.

        this.IMP.request_pay({

           // pg에는 포트원 > 결제연동에서 PG상점아이디 (사이트코드)를 넣어주면 된다

           // pg             : 'html5_inicis',

           // pg             : 'INIBillTst',// 정기 결제 KG이니시스. 이건 카드입력창이 뜬다

           // pg             : '9810030929',// 다날. 

           // pg             : 'nice.iamport00m',// 나이스 페이먼츠

           // pg             : 'T0000',// NHN KCP

           pg             : 'INIpayTest',// 일반 결제 KG이니시스

           pay_method,

           merchant_uid,

           name           : storeItem.name,

           amount         : storeItem.price.point,

           buyer_email    : this.ownerEmail,

           buyer_name     : this.ownerNickname,

 

           m_redirect_url : `${domain}/store/payment/done`, // 모바일은 리디렉션을 사용한다. 아래 콜백으로 값이 들어오지 x

           notice_url : `${apiBaseURL}/order/portone_webhook`,// 웹훅을 수신할 주소

 

         }, function(rsp) {// pc에서는 여기 iframe 콜백방식으로 처리한다

           if ( rsp.status == 'paid' ) {// 모바일과 동일하게 그대로 redirect한다

             self.$router.push(`/store/payment/done?imp_success=true&imp_uid=${rsp.imp_uid}&merchant_uid=${rsp.merchant_uid}`);

           } else {// 결제 실패시

             self.$router.push('/store/payment/done?imp_success=false');

           }

         });

- 2번에서 받은 merchant_uid를 인자로 함께 날린다.
- 그럼 merchant_uid를 기반으로 포트원에서 결제를 진행하며 가격에 틀림이 없는지 확인하고 문제가 없다면 결제를 한다.
- m_redirect_url 와 notice_url 가 핵심이다.
- m_redirect_url 결제가 끝나면 이동할 클라 url을 넣는다. 
- pc는 콜백으로 들어오고 모바일에서는 여기로 들어온다. 따라서 결제방법을 통일하기 위해 pc의 콜백을 쓰지 않고 결제 완료 후에는 항상 여기로 이동하게 한다.
- 쿼리스트링으로 3개의 값이 함께 들어온다.  imp_success는 결제성공여부, imp_uid, merchant_uid 등이다
- notice_url 는 결제가 완료되었을 때 포트원에서 내게 보낼 웹훅 주소를 넣어준다.
- 웹훅으로는 2개의 쿼리 스트링이 들어온다. imp_uid, merchant_uid

4. 포트원 doc을 보면 콜백 위주로 설명이 되어 있는데 이건 사용하지 않는다x
- 왜냐면 콜백을 이용할 경우 네트웍 상황에 따라 결제가 누락될수도 있기 때문이란다.
https://developers.portone.io/docs/ko/auth/guide/5/post?v=v1

5. 따라서 모든 결제 처리는 notice_url로 들어온 웹훅 정보를 기반으로 한다. 
- 하지만 이 경우에는 항상 웹훅으로 먼저 데이터 처리가 된 후에 콜백이 호출되야만 pc에서 $router.push() 했을 때 정보의 누락이 없게 된다.
- 포트원에서는 이를 위해 순서 보장이 필요하다면 메일로 알려달란다.

https://developers.portone.io/docs/ko/result/webhook?v=v1 
- 메일을 보내 순서 보장을 요청했더니 바로 처리되었다.

 

6. 이제 웹훅에서 가격이 바뀌지 않았는지만 확인하면 된다.
- 웹훅으로 imp_uid, merchant_uid 값이 들어온다.
- 먼저 포트원에서 토큰을 받은 후 imp_uid 를 기반으로 다시 포트원에 결제 정보를 요청해 받아온다.
- 결제 정보 안에는 결제와 관련한 모든 정보들이 들어있다.
- 이제 merchant_uid 로 내 db에서 2번할때 저장해 둔 order를 불러온다.
- 그리고 이 order에 있는 가격과 포트원에서 받아온 최종 결제 정보의 가격을 비교하여 틀린게 있는지 확인한다. 이게 사후검증이다.
- 둘의 값이 같다면 완전히 안전한 결제라는 뜻이다.
- 같다면 이제 포트원에서 받아온 결제정보를 내 order에 저장하면된다. 틀리다면 해당 order에 기록을 남기고 취소하면 된다.
- 리턴은 아무것도 할 필요 없다.

7. 실패했던 성공했던 결제가 끝나면 m_redirect_url 로 imp_success, imp_uid, merchant_uid 등 3개의 쿼리스트링이 함께 들어온다. 
- 이건 포트원에서 날려주는 것이다.
- 이 정보들을 받아서 그대로 다시 내 서버로 보내준다.
- 내 서버에선 이 쿼리스트링을 다시 포트원에 날려 최종 결제 정보를 받아온다. 
- 내 DB는 뒤질 필요가 없다. 그냥 포트원에 접속해서 정보를 가져오고 그걸 다시 클라로 보내주면 된다.
- 클라에서는 해당 결제 정보가 성공이라면 성공페이지를 보여주고 실패라면 실패 페이지를 보여주면 된다.

8. 결제루틴이 완전히 달라지면서 포인트 아이템 결제는 분기시켜 따로 처리했다.

 

이걸로 모든기기에서 결제, 환불, 취소 시스템 개발 완료

이제 pg사 계약 진행한다.