페이플 허브를 사용하시는 파트너사분들을 위해 허브 파트너 관리자를 쉽게 사용하실 수 있도록 제작된 매뉴얼입니다.
페이플 허브 API 연동가이드는 아래 링크를 참고해주세요!
•
페이플 - 파트너 관리자 매뉴얼 | https://info.payple.kr/partner/admin-manual
•
페이플 - 해외결제 파트너 관리자 매뉴얼 | https://info.payple.kr/global-admin-manual
이 글의 목차
페이플 허브(정산대행) 서비스를 확인할 수 있는 메뉴입니다.
아래 설명을 확인하시고 정산대행 서비스를 이용해보세요.
1. 허브 이용정보
허브 이용정보에 대해 확인할 수 있는 페이지입니다.
1.1 파트너 정보
기본적인 파트너 정보 확인이 가능합니다.
1.2 허브 이용정보
허브 이용정보의 변경이 필요하실 경우 고객센터(help@payple.kr)로 문의바랍니다.
고객센터(help@payple.kr)로 문의바랍니다.
1.
허브 상태
허브 상태는 신청, 승인, 승인거부, 종료로 구분됩니다.
2.
사용 요금제
사용하시는 요금제가 표시됩니다.
3.
사용 API
지급+실명API와 실명API로 구분됩니다.
•
지급+실명 API : 지급이체와 실명조회 모두 사용하는 경우입니다.
•
실명 API : 지급이체를 사용하지 않고, 계좌 실명조회만 사용하는 경우입니다.
4.
서비스 시작일
허브 서비스 이용 시작일을 말합니다.
•
서비스 시작일부터는 정산대금이 파트너 관리자 > 상점정보 > 기본정보에 등록된 계좌(파트너사의 실계좌)가 아니라, 허브용 정산계좌로 입금됩니다.
하위 셀러에 정산하고 남은 대금을 받고 싶다면 하위셀러에 지급이체하는 방식과 동일하게 파트너사 계좌로 지급이체를 실행해주시면 됩니다.
5.
지급이체 시작일
지급이체 이용 시작일을 말합니다.
6.
서비스 종료일
허브 서비스 이용 종료일을 말합니다.
•
서비스 종료일부터는 정산대금이 허브용 정산계좌에서 파트너 관리자 > 상점정보 > 기본정보에 등록된 계좌로 입금됩니다.
페이플 허브 서비스의 종료를 원하실 경우, 종료 예상 시점으로부터 최소 1개월 전에 페이플과 협의를 하셔야 합니다.
7.
custKey
상점정보 > 기본정보에서 확인할 수 있는 custKey와 동일합니다.
8.
허브 접근가능 IP(White IP)
등록된 IP로만 허브 접근이 가능합니다. 최대 6개까지 등록 가능합니다.
White IP 수정/삭제를 원하실 경우 페이플 고객센터(help@payple.kr)로 문의바랍니다.
9.
지급이체 실행 웹훅 URL
지급이체 실행 웹훅 URL을 설정하지 않으면 실행 결과를 별도로 받아볼 수 없기 때문에 웹훅 URL 설정을 적극 권장합니다.
•
설정하지 않으실 경우 지급이체 결과를 조회하려면 별도의 API 또는 허브 파트너 관리자로 로그인해야만 확인할 수 있습니다.
•
허브 파트너 관리자를 통해 실명인증, 지급요청과 실행 기능을 수동으로 이용하실 경우
웹훅 URL은 필수로 설정해주셔야 합니다.
2. 정산 내역
정산 내역을 조회할 수 있는 페이지입니다.
2.1 검색조건 설정
1.
검색일자
•
검색일자는 지난달, 이번달, 어제, 오늘, 1개월, 3개월을 선택하여 설정할 수 있고, 직접 지정하여 설정할 수도 있습니다.
•
검색일자의 기본값은 '오늘'로 설정되어 있습니다.
2.2 조회결과
1.
정산일
페이플로부터 정산 받은 날짜입니다.
2.
정산금액
페이플로부터 정산 받은 금액입니다. 신용카드와 계좌이체 각각의 정산금액과 합계금액을 확인하실 수 있습니다.
3.
수동입금액
누적된 지급이체 가능금액이 마이너스일 경우(예: 역환 발생 시) 지급이체 요청 및 실행이 중지됩니다. 이럴 경우 다음 정산일까지 기다리시거나 수동으로 페이플에 입금하여 진행할 수 있습니다.
4.
정산이체 시간
페이플로부터 허브용 정산계좌로 대금이 입금된 시간입니다.
5.
누적 지급이체 금액
하루동안의 지급이체 요청 및 실행, 실패금액을 표시하며, 조회 시마다 금액은 갱신됩니다.
•
요청 : 지급이체를 요청한 금액의 합계입니다.
•
실행 : 요청한 내역 중 이체 실행까지 완료한 금액의 합계입니다.
•
취소(거부) : 지급이체를 요청한 금액 중 취소(또는 거부된)한 금액의 합계입니다.
6.
지급이체 가능금액
누적된 정산금액 합계에서 실행된 지급이체 금액(요청+실행)을 제외한 나머지 금액입니다.
3. 계좌 실명인증 내역
계좌 실명인증 내역을 조회 및 요청할 수 있는 페이지입니다.
3.1 검색조건 설정
1.
검색일자
•
검색일자는 지난달, 이번달, 어제, 오늘, 1개월, 3개월을 선택하여 설정할 수 있고, 직접 지정하여 설정할 수도 있습니다.
•
검색일자의 기본값은 '오늘'로 설정되어 있습니다.
2.
사용가능 여부
상태는 가능, 불가로 구분되어 있습니다.
•
가능 : 실명 인증키(billing_tran_id)가 유효한 상태값입니다.
•
불가 : 실명 인증키(billing_tran_id)가 무효한 상태값입니다.
실명 인증키(billing_tran_id) 상태가 무효화 되는 사례는 이곳에서 확인해보세요.
에서 확인해보세요.3.
검색구분
Key, 예금주, 생년월일, 사업자번호, 계좌번호 중 하나를 선택하여 검색할 수 있습니다.
3.2 조회결과
1.
실명인증 요청
API 연동 없이 실명인증 요청을 수동으로 하는 기능입니다.
2.
상태
실명 인증키(billing_tran_id)의 상태이며 가능과 불가로 구분됩니다.
•
가능 : 실명 인증키가 유효한 상태로 수동 이체요청 기능을 이용할 수 있습니다.
•
불가 : 실명 인증키가 무효한 상태로 수동 이체요청 기능을 이용할 수 없습니다.
3.
sub_id
파트너사 하위 고객 ID 입니다.
4.
Key(billing_tran_id)
페이플 간편결제 서비스의 빌링키와 비슷한 개념입니다.
계좌 1개당 1개의 고유의 인증번호(billing_tran_id)를 갖습니다.
빌링키에 관한 개념은 여기서 확인해보세요.
서 확인해보세요.5.
기능
실명 인증키(billing_tran_id) 상태가 가능일 경우 지급이체 요청과 실행을 API 연동 없이 수동으로 하는 기능입니다.
6.
예금주
금융기관에서 리턴된 계좌의 실명값이 표기됩니다.
7.
구분
계좌는 사업자 또는 개인으로 구분되어 있습니다.
8.
생년월일/사업자번호
실명 조회한 계좌가 개인 계좌일 경우 예금주의 생년월일이 표시되며,
실명 조회한 계좌가 사업자 계좌일 경우 사업자번호가 표시됩니다.
9.
은행명
실명 조회한 계좌의 발급 은행입니다.
10.
계좌번호
실명 조회한 계좌의 계좌번호 입니다.
11.
조회일시
실명 조회한 일자와 시간입니다.
12.
상태변경 일시
실명 인증키(billing_tran_id) 상태가 변경된 일자와 시간입니다.
13.
4. 지급이체 요청내역
지급이체 요청내역을 조회할 수 있는 페이지입니다.
4.1 검색조건 설정
1.
검색일자
•
검색일자는 지난달, 이번달, 어제, 오늘, 1개월, 3개월을 선택하여 설정할 수 있고
직접 지정하여 설정할 수도 있습니다.
•
검색일자의 기본값은 '오늘'로 설정되어 있습니다.
2.
상태
상태는 요청, 실행, 취소, close, 거부로 구분되어 있습니다.
•
요청 : 실명인증을 마친 계좌에 대해 지급이체 요청(request)을 수행합니다.
•
실행 : 지급이체 실행(execute)이란 지급이체 요청(request)을 보낸 요청건에 대해 지급이체 수행을 실행하는 기능입니다.
•
취소 : 지급이체 취소는 지급이체 요청(request)건에 대한 취소이며, 이미 지급이체를 완료한건입니다. 즉, 지급이체 실행(execute)한 건에 대한 취소가 아닙니다.
•
close : 은행점검 시간은 close로 확인됩니다.
•
거부 : API 세부업무 처리실패로 표기되며 '지급이체 내역' 메뉴에서 자세한 내역을
확인하실 수 있습니다.
3.
검색 구분
distinct_key, group_key, billing_tran_id, 예금주, 생년월일, 사업자번호, 계좌번호, 지급요청액 중 하나를 선택하여 검색할 수 있습니다.
4.2 개요
1.
총 요청 건수
지급이체를 요청한 총 건수입니다.
2.
총 실행 건수
지급이체 요청이 실행된 총 건수입니다.
3.
총 취소 건수
지급이체 요청 건에 대한 취소된 총 건수입니다.
4.
총 close 건수
지급이체가 close된 총 건수입니다.
5.
총 거부 건수
지급이체가 거부된 총 건수입니다.
4.3 조회결과
1.
상태
지급이체 상태를 의미하며 요청, 실행, 취소, close, 거부로 구분되어 있습니다.
검색조건 설정에서의 상태와 같은 개념입니다.
2.
기능
지급이체 실행과 이체요청취소를 API 연동 없이 수동으로 하는 기능입니다.
3.
sub_id
파트너사 하위 고객 ID 입니다.
4.
distinct_key
파트너사 중복방지키입니다.
동일한 distinct_key값으로 지급이체 요청 시 거부되며 미 입력 시,
페이플에서 자동 발급됩니다.
5.
group_key/billing_tran_id
•
group_key : 지급이체 요청을 수행한 하나 이상의 거래건들을 하나의 그룹으로 묶은 키로
지급이체 실행 요청시 그룹키를 기준으로 지급이체를 수행하게 됩니다.
•
billing_tran_id : 페이플 간편결제 서비스의 빌링키와 비슷한 개념입니다.
계좌 1개당 1개의 고유의 인증번호(billing_tran_id)를 갖습니다.
6.
예금주
금융기관에서 리턴된 계좌의 실명값이 표기됩니다
7.
구분
계좌는 사업자 또는 개인으로 구분되어 있습니다.
8.
생년월일/사업자번호
실명 조회한 계좌가 개인 계좌일 경우 예금주의 생년월일이 표시되며,
실명 조회한 계좌가 사업자 계좌일 경우 사업자번호가 표시됩니다.
9.
은행명
실명 조회한 계좌의 발급 은행입니다.
10.
계좌번호
실명 조회한 계좌의 계좌번호 입니다.
11.
지급요청액
지급이체를 요청한 금액입니다.
12.
입금계좌인자내역
입금계좌 인자내역이며 파트너사명이 지정됩니다.
파트너사명이 6자가 넘을 경우 6자까지만 보여지고 그 이후의 값은 생략됩니다.
입금계좌 인자내역 상세 내용은 여기서 확인해보세요.
서 확인해보세요.13.
지급요청 일시
지급이체를 요청한 날짜와 시간입니다.
14.
지급이체 일시
지급이체가 실행된 날짜와 시간입니다.
15.
비고
상태값이 거부일 때 API 세부업무 처리실패로 표기되며 '지급이체 내역' 메뉴에서 자세한 내역을 확인하실 수 있습니다.
5. 지급이체 내역
지급이체 내역을 조회할 수 있는 페이지입니다.
5.1 검색조건 설정
1.
검색일자
•
검색일자는 지난달, 이번달, 어제, 오늘, 1개월, 3개월을 선택하여 설정할 수 있고, 직접 지정하여 설정할 수도 있습니다.
•
검색일자의 기본값은 '오늘'로 설정되어 있습니다.
2.
상태
상태는 성공, 실패, 지연으로 구분되어 있습니다.
•
성공 : 지급이체를 성공한 내역입니다.
•
실패 : 지급이체를 실패한 내역입니다.
•
지연 : 지급이체가 지연되고 있는 내역으로, 지속적으로 지급이체를 시도하고 있는 내역입니다. 추후 재조회 시 이체 결과에 따라 성공이나 실패로 상태가 변경됩니다.
3.
검색 구분
distinct_key, Key, 예금주, 생년월일, 사업자번호, 계좌번호, 지급액 중 하나를 선택하여 검색할 수 있습니다.
5.2 개요
1.
총 지급이체 금액
지급이체가 성공된 총 금액입니다.
2.
총 지급이체 건수
지급이체가 성공된 총 건수입니다.
5.3 조회결과
1.
상태
지급이체 상태를 의미하며, 성공, 실패, 지연으로 구분되어 있습니다.
검색조건 설정에서의 상태와 같은 개념입니다.
2.
sub_id
파트너사 하위 고객 ID입니다.
3.
distinct_key
파트너사 중복방지키입니다.
동일한 distinct_key값으로 지급이체 요청 시 거부되며 미 입력 시,
페이플에서 자동 발급됩니다.
4.
Key api_tran_id
지급이체가 성공 또는 실패될 때 발급받는 거래 고유 id이며, 이 Key값으로 해당 지급이체 요청건의 결과를 조회할 수 있습니다.
5.
예금주
지급이체한 계좌의 예금주가 표시됩니다.
6.
구분
계좌는 사업자 또는 개인으로 구분되어 있습니다.
7.
생년월일/사업자번호
•
지급이체한 계좌가 개인계좌일 경우 예금주의 생년월일이 표시됩니다.
•
지급이체한 계좌가 사업자계좌일 경우 사업자번호가 표시됩니다.
8.
은행명
지급이체한 계좌의 발급 은행입니다.
9.
계좌번호
지급이체한 계좌의 계좌번호입니다.
10.
지급액
지급이체한 금액입니다.
11.
지급요청 일시
지급이체를 요청한 날짜와 시간입니다.
지급이체를 실행한 날짜가 아니라, 지급이체를 요청한 날짜임을 유의하시기 바랍니다.
12.
지급이체 일시
받는 분 통장에 지급이체가 실행된 날짜와 시간입니다.(성공/실패/지연 모두 포함)
13.
이체 확인증
지급이체 성공 건에 한하여 이체 확인증을 확인하고 출력할 수 있습니다.
페이플이 파트너사로부터 지급이체를 요청받아 하위 셀러에게 계좌이체를 대행했다는 내용의 확인증으로 필요 시 사용하시면 됩니다.
(단, 거래의 참고용으로만 사용 가능하시며 법적효력은 없습니다.)
•
지급이체 요청사에 정산대행을 요청한 파트너사 이름이, 받는 분에는 입금받는 계좌의 예금주가 입력됩니다.
•
받는 분 통장표시 내용에는 지급이체 요청 시 별도 입력값이 없을 경우 파트너사명으로 입력됩니다.
•
출금자 정보에는 페이플 통장 정보가 입력되어 있습니다.
14.
이체결과 Webhook
페이플 허브에 등록된 웹훅 URL로 이체결과를 재 전송할 수 있습니다.
페이플 허브에서는 지급이체 실행(execute) 결과, 즉 실제로 지급이체가 완료된 결과에 대해 웹훅(Webhook)으로 발송하고 있습니다.
Webhook URL로는 지급이체 실행 결과가 발송되는데,
지급이체 실행(execute) 요청을 보낸 즉시가 아니라, 지급이체 실행(execute) 요청 후 실제로 지급이체가 완료되었을 때, 즉 파트너의 하위 고객사의 계좌에 실제로 지급이체가 수행된 후 발송됩니다.
페이플 허브 Webhook URL 등록 및 수정은 파트너에서 직접 할 수 없으며, 필요시 페이플 고객센터(help@payple.kr)로 요청주셔야 합니다.
15.
비고
성공, 실패 또는 지연처리된 에러 메시지가 출력됩니다.
실패 등의 에러 메시지는 이곳에서 확인해보세요.
에서 확인해보세요.6. 허브 사용 현황
허브 사용 현황을 조회할 수 있는 페이지입니다.
6.1 검색조건 설정
1.
검색일자
•
검색일자는 지난달, 이번달, 어제, 1개월, 3개월을 선택하여 설정할 수 있고 직접 지정하여
설정할 수도 있습니다.
•
검색일자의 기본값은 '어제'로 설정되어 있습니다.
2.
상태
상태는 실명인증, 지급이체로 구분되어 있습니다.
•
실명인증 : 실명인증이 성공한 내역입니다.
•
지급이체: 지급이체가 성공한 내역입니다.
6.2 개요
1.
총 실명인증 건수
실명인증이 성공된 총 건수입니다.
2.
총 지급이체 건수
지급이체가 성공된 총 건수입니다.
3.
총 건수 합계
실명인증과 지급이체가 성공된 총 건수입니다.
6.3 조회결과
1.
일자
실명인증 또는 지급이체가 성공된 일자입니다.
2.
실명인증 성공 건수
일자별 실명인증이 성공된 건수입니다.
3.
지급이체 성공 건수
일자별 지급이체가 성공된 건수입니다.
4.
합계
일자별 실명인증과 지급이체가 성공된 총 건수입니다.
Payple Inc. All rights reserved.