테스트 환경과 확인사항
발급받은 테스트 계정의 접속 정보와 서비스별 연동 전 확인사항, 테스트와 라이브 환경의 차이입니다. 라이브 키와는 값이 다릅니다.
국내 카드/계좌결제
페이플 가입 계약 심사가 완료되면 테스트 계정이 발급되며, 발급받은 테스트 계정으로 연동을 체험할 수 있습니다.
접속 도메인
https://democpay.payple.krcst_id
발급받은 cst_idcustKey
발급받은 custKeyclientKey
발급받은 clientKeyPCD_REFUND_KEY (결제취소 시 이용)
발급받은 PCD_REFUND_KEY테스트와 라이브 차이
| 구분 | 카드결제 | 계좌결제 |
|---|---|---|
| 인증 | 카드번호, 유효기간으로 카드 인증이 진행됩니다. 라이브환경에서는 카드번호, 유효기간, 생년월일, 비밀번호로 인증이 진행됩니다. | 실제 계좌로 인증 및 등록이 진행됩니다. |
| 실결제 여부 | 해당 카드로 실결제가 진행됩니다. | 가상으로 진행되기에 실제 출금이 진행되지 않습니다. |
| 취소 | 별도 취소처리하지 않아도 24시간 내에 자동 취소됩니다. 전체취소만 가능하며, 라이브 환경에서는 부분취소도 가능합니다. | 가상으로 진행됩니다. |
주의
라이브 환경 주의사항custKey, PCD_REFUND_KEY 처럼 외부에 노출되면 안 되는 키는 서버에서만 사용하세요. clientKey는 결제창 호출 JavaScript에서 쓰는 클라이언트키입니다. 테스트와 라이브 키는 환경별로 구분해 사용하세요.
참고
요청 header 설정파트너 인증시 referer 헤더의 값을 결제창이 호출될 도메인으로 입력해주세요. 별도의 테스트 계정을 발급 받으신 경우, 도메인을 검증하므로 등록한 도메인이 포함된 referer로 설정해야합니다.
해외 카드결제
페이플 가입 계약 심사가 완료되면 테스트 계정이 발급되며, 발급받은 테스트 계정으로 연동을 체험할 수 있습니다.
접속 도메인
https://demo-api.payple.krservice_id
발급받은 service_idservice_key
발급받은 service_keycode
영문+숫자 10자리 (직접 생성)연동 전 확인사항
| 항목 | 내용 |
|---|---|
| code | code 는 파트너 인증에 필요한 토큰을 확인하는 용도로 사용되며, 파트너(상점)가 직접 생성하여 전송해야 하는 중요한 요소입니다. code 생성규칙 영문+숫자 조합 10자리이며, 유효한 code 가 아닌 경우 T0211 응답코드를 수신합니다. |
| 국내 카드 화이트리스트 | 파트너(상점) 당 1개의 화이트리스트 처리 가능합니다. 테스트 환경에서는 국내(KR), 해외발행카드 모두 이용 가능하지만, 라이브 환경에서는 해외발행카드만 이용 가능합니다. 라이브 환경에서 국내(KR)발행카드로 테스트를 위해서는 고객센터(help@payple.kr)를 통한 화이트리스트 처리 요청이 필요합니다. |
| 화이트(White) IP 등록 | 페이플 해외 카드결제는 등록되어있는 IP 와의 통신만 허용되며, 등록은 고객센터(help@payple.kr)로 요청이 필요합니다. 테스트 환경에서는 화이트 IP 등록이 필요없습니다. |
| 위험국가 리스트 | 위험국가에서 발행된 카드는 이상거래탐지시스템(Decision Manager)에 의해 결제가 거부됩니다. 위험국가 코드는 여기에서 확인할 수 있습니다. |
해외 간편결제
해외 간편결제(Alipay+)는 현재 운영 환경에서만 제공 중입니다. Alipay+ 테스트 환경은 지원되지 않습니다.
연동 전 확인사항
| 항목 | 내용 |
|---|---|
| code | code 는 파트너 인증에 필요한 토큰을 확인하는 용도로 사용되며, 파트너(상점)가 직접 생성하여 전송해야 하는 중요한 요소입니다. code 생성규칙 영문+숫자 조합 10자리이며, 유효한 code 가 아닌 경우 T0211 응답코드를 수신합니다. |
| 결제 통화 | 현재 Alipay+만 지원되며 결제 통화는 CNY 입니다. 결제창 요청 시 currency 를 생략하면 CNY 로 처리됩니다. CNY 최소 결제금액은 1 입니다. Alipay+는 중국 신분증을 가진 고객만 결제가 가능합니다. |
| 화이트(White) IP 등록 | 페이플 해외 결제는 등록되어있는 IP 와의 통신만 허용되며, 등록은 고객센터(help@payple.kr)로 요청이 필요합니다. |
정산지급대행 (정산지급대행, 계좌조회)
페이플 가입 계약 심사가 완료되면 테스트 계정이 발급되며, 발급받은 테스트 계정으로 연동을 체험할 수 있습니다.
접속 도메인
https://demohub.payple.krcst_id
발급받은 cst_idcustKey
발급받은 custKey연동 전 확인사항
| 항목 | 내용 |
|---|---|
| 화이트(White) IP 등록 | 페이플 정산지급대행은 등록된 IP와의 통신만 허용되며, IP 등록은 두가지 방법으로 가능합니다. 정산지급대행 파트너 관리자 > 정산지급대행 이용정보 > White IP추가 고객센터(help@payple.kr)로 등록 요청 |
테스트와 라이브 차이
| 구분 | 내용 |
|---|---|
| 테스트 환경(demo) | 테스트 환경(demo)에서는 계좌조회 요청 시 실제 계좌 검증이 이루어지지 않습니다. 모든 요청은 고정된 유효 계좌 응답으로 반환되며, 실제 계좌 유효성 검증은 운영 환경에서만 수행됩니다. |
참고
통신 보안파트너사는 TLS v1.2 이상 / SSL 보안 통신(HTTPS)을 필수적으로 적용해야 합니다.