토스페이먼츠
카드 · 계좌이체 · 가상계좌.
토스페이먼츠는 온라인으로 가입하고 키 두 개만 넣으면 됩니다. 카드 · 계좌이체 · 가상계좌 · 간편결제를 한 결제창에서 받습니다.
토스페이먼츠 개발자센터에 로그인하면 API 키 메뉴에 클라이언트 키와 시크릿 키가 있습니다. 테스트 키는 test_ 로, 운영 키는 live_ 로 시작합니다. 계약 전에는 테스트 키만 보입니다.
"사용할 결제수단" 에서 토스페이먼츠에 체크하고, 아래 토스페이먼츠 칸에 클라이언트 키 · 시크릿 키를 넣습니다. 테스트 모드가 켜져 있으면 테스트 키를, 껐으면 운영 키를 넣습니다. 저장.
토스페이먼츠 칸의 웹훅 주소를 복사해 개발자센터 > 웹훅 설정에 등록합니다. 이벤트는 결제 상태 변경(PAYMENT_STATUS_CHANGED)을 고릅니다. 가상계좌 입금 통지가 이 주소로 옵니다.
상품을 주문하고 결제 화면에서 토스페이먼츠를 고릅니다. 테스트 모드에서는 결제창에 테스트용 카드가 안내됩니다. 결제가 끝나면 콘솔 주문이 결제완료가 됩니다.
페이 설정 > 결제 내역에 결제수단 "toss", 상태 "결제 완료" 로 한 줄이 생기고, 결제 상세의 PG 거래번호에 토스 paymentKey 가 보입니다.
운영 전환
- 계약 승인 후 개발자센터에서 운영 키(
live_)를 확인합니다. - 짓미페이 결제수단 탭의 키를 운영 키로 바꿉니다.
- 기본 탭 테스트 모드를 끕니다.
- 소액 실결제 후 결제 상세에서 결제 취소로 되돌립니다.
카드 · 계좌이체 · 가상계좌 · 휴대폰 · 간편결제 중 무엇을 켤지는 토스페이먼츠 상점관리자에서 정합니다. 짓미페이는 상점관리자의 설정을 그대로 따릅니다.
"시크릿 키가 올바르지 않습니다": 테스트 모드와 키 종류가 어긋난 경우입니다. 테스트 모드면 test_, 아니면 live_. 가상계좌 입금이 반영 안 돼요: 웹훅 주소 등록을 빠뜨렸거나 방화벽이 막은 경우입니다. 통신 로그에 webhook 줄이 없으면 등록 문제입니다.