PG 연결·카드결제 설정

토스페이먼츠를 연결하려면 토스페이먼츠 키 확인하는 방법에서 결제용·현금영수증용 키 위치를 확인하세요.

PG 선택과 키 자동 저장#

1. 카드결제설정 열기
   마이페이지 → 카드결제설정으로 이동합니다. PG 가입·심사가 필요하면 ‘카드결제 신청’의 ‘신청하기’를 이용합니다.
2. 키 입력 영역 열기
   ‘카드결제 사용’을 켜면 ‘카드결제 KEY’가 펼쳐집니다. 직접 키를 입력하려면 ‘테스트 모드’를 끄고 ‘셀프 카드결제 PG’에서 LightPay 또는 토스페이먼츠를 고릅니다.
3. 선택한 PG 정보 입력
   LightPay는 MID·가맹점 키와 결제 유효시간(1~168시간, 기본 24시간)을 입력합니다. 토스페이먼츠는 같은 상점·환경의 클라이언트 키와 시크릿 키를 입력합니다. PG별로 등록한 키는 따로 보관됩니다.
4. 자동 저장 완료 확인
   스위치·PG 선택과 키 입력은 자동 저장됩니다. 입력을 마치고 ‘자동 저장되었습니다’를 확인한 뒤 이동하세요. 입력을 마치라는 안내가 있으면 필수 키를 모두 채우고, 실패하면 ‘다시 시도’로 재저장한 뒤 결과를 확인합니다.

고객 주문에서 카드결제 제공하기#

신규 계정의 ‘카드결제 사용’은 기본적으로 꺼져 있습니다. PG 계약·심사와 운영 키를 준비한 뒤 켜고, 저장 완료 후 고객 페이지에서 카드결제 선택지를 확인하세요. 끄면 KEY 입력 영역이 숨겨지며 등록한 키는 유지됩니다. 이 스위치는 고객 셀프모드의 카드결제 설정이며, 판매자가 SMS 결제 링크를 발송하는 기능과 별도입니다.

등록한 키를 유지하면서 테스트 모드 사용하기#

‘테스트 모드’를 켜면 선택한 PG의 기본 테스트 키로 셀프 카드결제를 진행합니다. 등록한 가맹점 키는 유지되고 키 입력은 비활성화됩니다. 끄면 저장된 키를 사용하므로 고객에게 실제 주문을 받기 전에 테스트 모드와 키 환경을 함께 확인하세요. 테스트 모드를 켜는 것만으로 ‘카드결제 사용’이 켜지지는 않습니다. 이 스위치는 현금영수증 키의 테스트·라이브 환경을 바꾸지 않습니다.

저장된 키 보기·복사#

저장된 키는 일부만 표시됩니다. 입력칸 옆 ‘보기’를 누르면 전체 키를 확인·수정할 수 있고 버튼이 ‘복사’로 바뀝니다. 수정 후에는 자동 저장 완료를 확인하세요. 키를 문의 글이나 공유 화면에 그대로 넣지 마세요.

카드결제 추가금 설정하기#

‘카드결제 추가금’에 0~100%를 소수점 둘째 자리까지 입력합니다. 값을 바꾸면 자동 저장되며, 실패하면 추가금 항목의 ‘다시 시도’를 누릅니다. 0%는 추가금이 없습니다.

등록상품의 일반 카드결제에서 상품금액에만 적용되며 배송비·셀프정산·SMS 링크결제에는 적용되지 않습니다. 예를 들어 상품금액 10,000원, 배송비 3,000원에 3%를 설정하면 추가금 300원, 합계 13,300원입니다. 주문 전 체크아웃의 추가금과 합계를 확인하고, 접수 후에는 주문·결제 상세에 저장된 금액을 확인하세요.

결제통보 주소 등록하기#

‘카드결제 사용’을 켜고 테스트 모드를 끈 상태에서 본인 가맹점의 운영 키가 저장되어야 ‘결제통보 웹훅 URL’과 ‘복사’가 표시됩니다. 토스페이먼츠는 웹훅 등록 안내를 따릅니다. LightPay는 화면 안내에 따라 결제 데이터 통보의 신용카드(인증) 행에 URL/IP를 붙여 넣고 UTF-8·JSON으로 저장합니다. PG나 키를 바꿨다면 현재 표시된 주소를 다시 확인하세요.

실사용 전 확인하기#

‘자동 저장되었습니다’는 설정값 저장 결과입니다. 실제 판매에는 PG 가입·심사, 운영 키와 카드결제 사용 여부까지 확인해야 합니다. 결제 후 결과가 늦게 반영되면 같은 결제를 반복하기 전에 결제내역 상세와 상태 확인을 사용합니다.