🌠redirect 결제창 결과처리

새로운창으로 리디렉션되어 결제가 진행되는 환경에서의 결과 처리 방법을 안내합니다.

아래 예제 코드는 결제창 형태가 새로운페이지로 리디렉션되어 결제가 진행되는 대부분의 모바일 환경에서의 결제요청애 대한 응답을 처리하는 부분입니다.

JavaScript

client-side

IMP.request_pay({
      /* ...중략... */,
      m_redirect_url: "{리디렉션 될 URL}" 
  }, /* callback */);     // callback은 실행 안됨

JavaScript (ES Next)

client-side

IMP.request_pay({
      /* ...중략... */,
      m_redirect_url: "{리디렉션 될 URL}" 
}, /* callback */); // callback은 실행 안됨

위와같이 request_pay 함수 파라미터로 m_redirect_url 을 설정하면 결제 완료 이후 해당 URL 주소로 결제 결과를 쿼리스트링(Query String) 형태로 전송해 드립니다.

Query String 이란?

URL 뒤에 데이터를 전달하는 가장 단순한 방법으로 주로 GET방식으로 데이터를 전송할때 사용하는 방법입니다.

결제결과를 수신받을 endpoint url 주소를 m_redirect_url 에 설정하시면 결제결과 수신이 가능합니다.

GET https://가맹점 도메인주소/complete

아래 파라미터를 설정하신 URL 을 통해 Query String 형태로 수신받을수 있습니다.

Query Parameters

Name	Type	Description
imp_uid*	String	아임포트 결제 고유번호
merchant_uid*	String	가맹점 주문번호
imp_success*	String
error_code	String	실패코드(결제 실패인 경우 수신)
error_msg	String	실패메세지(결제 실패인 경우 수신)

아래는 Query String 으로 리디렉션되는 URL 예제입니다.

결제완료/가상계좌 발급완료

curl https://myservice.com/payments/complete?imp_uid=결제건을_특정하는_아임포트_번호&merchant_uid=가맹점_고유_주문번호&imp_success=true

결제 실패

curl https://myservice.com/payments/complete?imp_uid=결제건을_특정하는_아임포트_번호&merchant_uid=가맹점_고유_주문번호&imp_success=false&error_code=에러_코드(현재_정리된_체계는_없음)&error_msg=에러_메시지

결제창이 리디렉션되어 새로운 페이지에서 활성화되는 경우 결제 결과는 callback 으로 받을 수 없습니다.

최종 결제결과 로직처리는 반드시 웹훅을 이용하여 안정적으로 처리해 주셔야 합니다.

웹훅연동을 생략하시는 경우 결제결과를 정상적으로 수신받지 못하는 상황이 발생합니다.

결제 완료의 의미

결제완료는 아래의 모든 경우를 포함합니다.

1. 결제 성공(결제 상태: paid, imp_success: true)

2. 결제 실패(결제 상태: failed, imp_success: false)

3. PG 모듈 설정이 올바르지 않아, 결제 창이 열리지 않음

4. 사용자가 임의로 X 버튼이나 취소 버튼을 눌러 결제를 종료함

5. 카드 정보 불일치, 한도 초과, 잔액 부족 등의 사유로 결제가 중단됨

6. 가상계좌 **발급 완료(**결제 상태: ready, imp_success: true)

imp_success 파라미터

imp_success 파라미터는 결제 프로세스 정상 종료 여부를 의미합니다. 하지만 클라이언트 상에서 자바스크립트 함수를 호출해서 결제창이 열리므로 결제금액이 위변조 되었을 가능성이 있기 때문에 이 값으로 결제의 성공 여부를 판단해서는 안됩니다. 결제의 성공 여부에 따라 아래와 같이 처리합니다.

• imp_success = true: 결제 정보(imp_uid, merchant_uid)를 서버에 전달 해서 결제금액의 위변조 여부를 검증한 후 최종적으로 결제 성공 여부를 판단합니다.

• Imp_success = false: 결제가 실패했음을 사용자에게 알립니다.

* 일부 PG사에 한해 imp_success가 아닌 success 파라미터가 전달되거나 아예 전달되지 않는 경우(예: KG이니시스 - 실시간 계좌이체)도 있으니 주의하셔야 합니다.