연동준비

정산지급대행 (정산지급대행, 계좌인증)

API 키, 테스트 정보

페이플이 제공하는 테스트 정보를 통해 계약 전 단계에서도 누구나 연동 체험이 가능합니다.

1. 접속정보

	내용
접속 도메인	https://demohub.payple.kr
cst_id	test
custKey	abcd1234567890

·통신 보안

파트너사는 TLS v1.2 이상 / SSL 보안 통신(HTTPS)을 필수적으로 적용해야 합니다.

2. 확인사항

	내용
화이트(White) IP 등록	페이플 정산지급대행은 등록된 IP와의 통신만 허용되며, IP 등록은 두가지 방법으로 가능합니다. ·정산지급대행 파트너 관리자 > 정산지급대행 이용정보 > White IP추가 ·고객센터(help@payple.kr)로 등록 요청
테스트 환경(demo)	테스트 환경(demo)에서는 계좌인증 요청 시 실제 계좌 검증이 이루어지지 않습니다. 모든 요청은 긍정된 유효 계좌 응답으로 반환되며, 실제 계좌 유효성 검증은 운영 환경에서만 수행됩니다.

웹훅(Webhook)

페이플 웹훅을 이용하면 이체실행 결과수신이 가능합니다.

1. 수신가능 이벤트

이벤트	설명
이체실행 완료	상대방 계좌에 이체를 완료한 건을 수신합니다.

·라이브

라이브 환경에서 웹훅 등록은 고객센터(help@payple.kr)로 요청이 필요합니다.

2. 수신 데이터 설명과 예시

2.1 이체실행 완료

정산지급대행 이체실행 완료

JSON

1{
2  "result": "결과",
3  "message": "응답 메시지",
4  "cst_id": "파트너 ID",
5  "sub_id": "파트너 하위고객 ID",
6  "group_key": "실행 그룹 키",
7  "billing_tran_id": "빌링키",
8  "api_tran_id": "거래고유번호",
9  "api_tran_dtm": "이체일시",
10  "bank_tran_id": "은행 거래고유번호",
11  "bank_tran_date": "이체일자",
12  "bank_rsp_code": "기관 응답코드",
13  "bank_code_std": "기관 표준코드",
14  "bank_code_sub": "기관 점별코드",
15  "bank_name": "기관명",
16  "account_num": "계좌번호",
17  "account_num_masked": "가림 처리된 계좌번호",
18  "account_holder_name": "예금주",
19  "print_content": "입금계좌인자내역",
20  "tran_amt": "이체금액"
21}

정산지급대행 이체실행 완료 예시

JSON

1{
2  "result": "A0000",
3  "message": "처리 성공",
4  "cst_id": "test",
5  "sub_id": "test12385610",
6  "group_key": "Q0RSSkYzWUI3...",
7  "billing_tran_id": "6fen3g2m-j9hb-...",
8  "api_tran_id": "ohr8ps3m-j5x...",
9  "api_tran_dtm": "20211025142315647",
10  "bank_tran_id": "M202112389U142315646",
11  "bank_tran_date": "20211025",
12  "bank_rsp_code": "000",
13  "bank_code_std": "020",
14  "bank_code_sub": "0000000",
15  "bank_name": "우리은행",
16  "account_num": "1234567890123456",
17  "account_num_masked": "1234567890123***",
18  "account_holder_name": "홍길동",
19  "print_content": "정산테스트",
20  "tran_amt": "1000"
21}