정기,구독결제

정기결제는 카드정보를 미리 등록해두고 원하는 때에 고객의 별도 인증 없이 결제를 요청하는 방식으로 구독결제를 구현할 수 있습니다.
ㆍ빌링키 발급 : 빌링키를 발급받기 위해서는 최초결제를 필요로 하며 이 때에는 3DS인증을 진행하게 됩니다.
ㆍ비인증 결제 : 발급받은 빌링키로 결제를 할 때에는 비인증으로 API전송을 통해 결제가 진행됩니다.

비인증결제의 이해 Tutorial

redirect url로 결과처리하기

Next Step
빌링키발급 및 첫결제완료 이후 success_url 또는 failure_url로 결과가 리디렉션 됩니다.
리디렉션되는 페이지에 아래의 쿼리 스트링(Query String)값을 파싱하여 결과처리를 진행합니다.
리디렉션되는 결과값에 대한 위변조 여부 검증로직을 통해 무결성을 확인할 수 있습니다.

빌링키발급 API 호출시 설정한 redirect url로 아래의 결과가 전달됩니다.
결제가 성공해야지만 빌링키가 발급되기 때문에 빌링키발급 및 첫결제결과로서 처리할 수 있습니다.

order_ref

string
포트원 거래번호
결제에 대해 포트원에서 채번한 거래번호입니다.
빌링키조회, 빌링키발급 시 첫결제상세조회 API에서 사용될 수 있습니다.

channel_order_ref

string
결제채널 거래번호
빌링키발급 및 결제가 진행된 결제채널(PSP)에서 채번한 거래번호입니다.

merchant_order_ref

string
고객사 주문참조번호
통합결제창이나 정기결제에서는 포트원에서 통합결제창을 호출 시 생성한 번호가 설정되어 내려갑니다.

subscription_order_ref

string
정기결제 참조번호
빌링키 생성 성공 시 포트원에서 채번한 값으로 빌링키로 활용됩니다.

status

string
처리상태
처리상태 코드에 대한 설명입니다.

status_code

number
처리상태 코드
처리상태를 코드로 분류한 값입니다.

status_reason

string
처리실패 사유
처리실패 시 사유에 대한 설명입니다.

status_channel_reason

string
PSP로 부터 수신한 결제결과코드와 결제결과메시지
PSP로 부터 수신한 결제결과코드와 결제결과메지를 '|'로 연결하여 bypass 합니다.

signature_hash

string
해쉬검증값
리디렉션 값의 위변조를 검증하기 위한 값입니다.
해쉬값 검증로직을 참고해 주세요.
창 닫음, 새로고침, 뒤로가기, 네트워크 오류 등으로 리디렉션은 유실될 수 있습니다.
최종결과 로직처리는 반드시 웹훅을 이용하여 안정적으로 처리해 주셔야 합니다.