용어 정의

1 more property

이 글의 목차

파트너 관리자 매뉴얼의 용어를 정의합니다.

개발과 관련된 자세한 내용은 연동가이드에서 확인해주세요.

API(Application Programming Interface)

API란, 애플리케이션 프로그래밍 인터페이스의 줄임말로 운영체제와 응용프로그램 사이의 통신에 사용되는 언어나 메시지 형식을 의미합니다. 쉽게 말해, 프로그램이 상호 작용하는 것을 도와주는 매개체입니다.

참고해주세요!

파트너사에서 페이플 서비스를 이용하는 방법은 크게 2가지가 있습니다.

파트너 관리자 페이지

파트너사는 파트너 관리자 페이지에 접속해서 상점을 운영 및 관리할 수 있습니다.

서버에서 API 연동

파트너사와 페이플 서버간 API통신을 통해 서비스를 이용할 수 있습니다.

VAT(부가가치세)

VAT(부가가치세)란, 제품이나 용역이 생산·유통되는 모든 단계에서 기업이 새로 만들어 내는 가치인 부가가치에 대해 부과하는 세금입니다.

현재 우리나라는 과세 상품에 대해 최종가격에 10%의 부가가치세가 포함됩니다.

빌링키(PAYER_ID)

빌링키(PAYER_ID)란, 계좌 및 카드정보를 암호화 한 키 값입니다.

PCD_PAYER_ID = "빌링키"
JavaScript
복사
빌링키 요청 변수

민감한 개인금융정보인 계좌정보 및 카드정보를 교환하는 경우 보안상 문제가 발생할 수 있습니다.

이 문제를 예방하기 위해 페이플에서는 계좌 및 카드정보와 매칭되는 고유식별정보를 암호화한 키 값인 빌링키(Billing Key)를 생성하여 파트너사에게 제공하고 있습니다.

간편결제 및 정기결제에서는 이 빌링키(PAYER_ID)가 필수적으로 사용됩니다.

페이플에서 제공하는 결제창에서 고객에게 입력받은 계좌 및 카드 정보를 페이플에서는 빌링키로 변환하여 파트너사에 전달합니다. 이후 결제부터는 파트너사에서 빌링키를 페이플에 전달하여 처리하게 됩니다.

카드결제에서의 빌링키 방식에 대한 자세한 설명은 이곳에서 확인해보세요.

계좌이체에서의 빌링키 방식에 대한 자세한 설명은 이곳에서 확인해보세요.

월 결제한도 및 잔여한도

예시) 파트너 관리자 > 상점정보 > 결제한도/보증보험 페이지에서 확인가능한 월 결제한도 및 잔여한도

월 결제한도란, 한 달에 결제 가능한 최대 한도금액을 의미합니다.

잔여한도란, 현 시점에서 남아있는 결제가능 금액을 의미하며, 월 결제한도에서 이번 달 현 시점의 결제금액을 뺀 값입니다.

잔여한도 = 월 결제한도 - 이번 달 현 시점의 결제금액

월 중복결제 방지

월 중복결제 방지란, 월 1회(단 한 차례)만 결제가 되어야하는 서비스를 지원하기 위해 페이플에 이미 등록되어있는 카드/계좌의 빌링키별로 월 1회를 초과하는 결제시도를 차단하는 기능입니다.

월 중복결제 방지 기능을 이용하실 경우, 하나의 계좌 및 카드로 같은 과금년월에 결제를 중복으로 할 수 없게 결제시도를 차단할 수 있습니다.

예시) 결제내역 페이지 - 과금년월

월 중복결제 방지는 빌링키(PAYER_ID)가 발급되지 않는 앱카드 결제에는 적용되지 않습니다.

웹훅(Webhook) URL

웹훅이란, 응용 프로그램에서 어떤 이벤트가 발생했을 때 다른 응용 프로그램으로 실시간 정보를 제공하는 방법입니다.

파트너사로부터 들어온 결제요청을 처리하는 경우, 간혹 네트워크 지연 및 기타 사정으로 인하여 카드사나 은행으로부터 결제결과에 대한 응답 메시지가 오지 않거나, 지연되는 현상이 발생할 수 있습니다. 이런 경우 파트너사는 결제결과를 받을 수 없으며, 페이플 관리자 사이트의 내역과 파트너사에서 받은 결제 내역이 차이가 생길 수 있습니다.

이를 예방하기 위해 페이플에서는 웹훅 URL을 지원합니다.

파트너사에서 페이플로부터 데이터를 수신할 수 있는 웹페이지(URL)을 설정하게 되면 페이플에서 해당 URL로 데이터를 전송합니다. 결제결과 수신뿐만 아니라 등록된 계좌나 카드(빌링키)가 해지될 때도 웹훅 URL로 데이터를 전송합니다.

{
"PCD_PAY_RST" => "success",
"PCD_PAY_MSG" => “결제결과 리턴 메시지”,
"PCD_CST_ID" => “가맹점 ID”,
"PCD_PAY_OID" => “주문번호”,
"PCD_PAY_TYPE" => “card”,
"PCD_PAYER_NO" => “회원번호”,
"PCD_PAYER_ID" => “계좌(카드)등록후 리턴받은 빌링키”,
"PCD_PAY_YEAR" => “월 중복결제 년”,
"PCD_PAY_MONTH" => “월 중복결제 월”,
"PCD_PAY_GOODS" => “상품명”,
"PCD_PAY_TOTAL" => “상품금액”,
"PCD_REGULER_FLAG" => “월 중복결제 방지 사용여부”,
"PCD_REFUND_TOTAL" => “환불금액”,
"PCD_REFUND_TIME" => “환불시간”,
"PCD_PAYCANCEL_FLAG" => 'Y'
}
PHP
복사
예시) 결제결과 수신 데이터 - 설정한 웹훅 URL로 전송되는 데이터 샘플양식

{
"PCD_CST_ID" : “가맹점 ID”,
"PCD_PAY_WORK" : "PUSERDEL",
"PCD_PAY_RST" : "success",
"PCD_PAY_MSG" : "2008 : 고객요청으로 자동이체 해지되었음(업체해지)",
"PCD_PAY_TYPE" : “card”,
"PCD_PAYER_ID" : “계좌(카드) 등록시 리턴받은 빌링키”,
"PCD_PAYER_NAME" : “이름”,
"PCD_PAYER_HP" : “결제고객 핸드폰번호”
}
PHP
복사
예시) 계좌(카드) 해지 수신 데이터 - 설정한 웹훅 URL로 전송되는 데이터 샘플양식

웹훅(Webhook) URL 설정에 대한 자세한 설명은 이곳에서 확인해보세요.