KPN Logo

테스트 환경

결제 연동 테스트를 위한 환경과 계정 정보입니다.

테스트 환경 안내

테스트 환경에서는 가상으로 결제가 승인되기 때문에 승인 요청을 하더라도 실제 결제수단에서 돈이 출금되지 않아요.

실제 승인이 발생하는 결제수단

다음 결제수단은 테스트 환경에서도 실제 결제가 발생하니 주의하세요:

  • 간편결제: 토스페이 머니, 네이버페이 머니(신용카드 X), 페이코, 카카오페이 머니
  • 휴대폰: 모빌리언스, 다날 인증사를 사용할 경우 (갤럭시아, 헥토파이낸셜은 해당 없음)

테스트 환경에서 실 승인난 결제 건은 매일 11:30에 일괄 취소처리됩니다.

지원하지 않는 도메인

아래 도메인에 대해서는 개발자 센터에서 다루지 않으니, 문의사항이 있는 경우 문의하기 를 이용해주세요.

  • 개발환경: testpg.firstpay.co.kr, testps.firstpay.co.kr
  • 운영환경: pg.firstpay.co.kr, ps.firstpay.co.kr

결제수단별 테스트 환경

결제수단테스트 환경 동작주의사항
신용카드가상 승인 (실제 출금 X)유효한 카드번호로 테스트해도 실제 결제 안됨
간편결제⚠️ 실제 승인토스페이 머니, 네이버페이 머니, 페이코는 실제 결제됨
가상계좌가상 채번실 입금이 아닌 별도 API로 입금 테스트 가능
휴대폰⚠️ 일부 실제 승인모빌리언스, 다날 사용 시 실결제 발생
계좌이체가상 승인-

테스트 vs 운영 환경

구분테스트 환경운영 환경
결제창 서버 도메인https://dev.firstpay.co.krhttps://pay.firstpay.co.kr
인증서버 도메인https://authst.kpn.co.krhttps://auth.kpn.co.kr
SDK env 값developproduct
실제 결제❌ 대부분 가상 결제✅ 실제 출금
인증서버 도메인

인증서버 도메인은 브랜드페이 Access Token 발급 등 인증이 필요한 연동에서 사용합니다.

테스트 계정 정보

개발 단계에서는 아래 테스트 계정을 사용하세요.

항목값
가맹점 ID (mxId)testcorp
보안 키 (passKey)6aMoJujE34XnL9gvUqdKGMqs9GzYaNo6

브랜드페이 테스트 계정

브랜드페이 연동에 필요한 clientId, secretKey는 별도 발급 항목입니다.

항목값
가맹점 ID (mxId)testcorp
clientId발급은 문의하기로 문의
secretKey발급은 문의하기로 문의
브랜드페이 자격 정보 발급

브랜드페이 clientId, secretKey는 보안상 문서에 값을 게시하지 않습니다. 브랜드페이 연동 자격 정보 발급이 필요하시면 문의하기로 요청해 주세요.

보안 팁
  • passKey와 secretKey는 절대로 클라이언트(브라우저)에 노출하지 마세요.
  • passKey와 secretKey는 서버 측에서만 사용해야 합니다.
  • Git에 키를 커밋하지 않도록 .gitignore에 .env.local을 추가하세요.

SDK 환경 설정

javascript
// 테스트 환경
const pay = new FirstPay({
  env: 'develop',
  openType: 'popup'
});

// 운영 환경
const pay = new FirstPay({
  env: 'product',
  openType: 'popup'
});

다음 단계

테스트 환경 설정을 완료했다면, 다음 문서를 참고하여 결제 연동을 시작하세요.