주요 내용
위치: Settings
Open this page: admin.<your-site>/settings (replace <your-site> with your site address)
Check 1: test or live?
- 테스트 모드는 테스트 키를 사용합니다. 실제 금액이 결제되지 않습니다. 화면에 다음과 같이 표시됩니다: "Test mode: readers can’t buy until you add live keys. Test payments here never give readers access."
- 라이브 모드는 실제 결제를 진행합니다. 먼저 이용약관, 환불 정책, 문의처 페이지를 발행해야 합니다.
Check 2: the keys
키 ID는 모드에 따라 시작하는 글자가 다릅니다. Razorpay의 경우 테스트는 rzp_test_, 라이브는 rzp_live_로 시작합니다. Stripe 공개 가능 키는 pk_test_ 또는 pk_live_로 시작합니다. PayPal 연결에는 Client ID, Secret, Webhook ID가 사용됩니다.
| Message | Fix |
|---|---|
| "Razorpay didn’t accept these keys. Check that the key id and secret are from the same mode." | 동일한 대시보드의 동일한 모드에서 키와 시크릿을 모두 복사하세요. |
| "This is a live key but you chose Test mode. Switch the mode or paste a test key." | 모드와 키의 종류를 일치시키세요. |
| "This is a test key but you chose Live mode. Switch the mode or paste a live key." | 모드와 키의 종류를 일치시키세요. |
| "Paste the key secret. Razorpay shows it only once, when you create the key." | 대시보드에서 새 키를 생성한 후 시크릿을 즉시 복사하세요. |
| "Use a different webhook secret for test and live." | 테스트용과 라이브용 시크릿을 서로 다르게 만드세요. |
| "Publish your Terms, Refund and Contact pages before going live." | 해당 페이지들을 발행한 다음 라이브 모드로 전환하세요. |
Check 3: the webhook
웹훅은 결제가 완료되었을 때 이를 사이트에 알려줍니다. 웹훅이 없으면 주문이 결제 완료 상태로 바뀌지 않습니다.
- 연결 카드에서 웹훅 URL을 복사합니다.
- 결제 대행사 대시보드에 접속하여 웹훅으로 추가합니다. 카드에 안내된 이벤트 항목들을 체크합니다.
- 결제 대행사에서 웹훅 시크릿을 입력하고, 동일한 시크릿을 연결 설정에 붙여넣습니다.
- 저장합니다.
Check 4: run a test payment
테스트 모드 상태에서 연결 카드의 테스트 결제 버튼을 누릅니다. 결제 대행사가 승인하면 주문이 결제 완료로 표시됩니다. 테스트 결제창이 열리지 않으면 관리자 페이지의 팝업 허용 여부를 확인하세요. 결제에 실패하면 "The test payment didn’t go through. Check the connection and try again." 메시지가 표시됩니다.
Messages readers may see
- "Payments aren’t set up on this site yet." 연결된 결제 대행사가 없습니다.
- "Live payments aren’t switched on for this site yet. Use test mode for now." 라이브 모드 설정을 완료하세요.
- "The payment gateway didn’t answer. Nothing was charged or refunded. Try again in a minute." 결제 대행사 서버가 혼잡합니다. 잠시 후 다시 시도해 보세요.
- "This checkout has expired. Start again." 결제를 처음부터 다시 진행하세요.
- "This payment method isn’t offered here. Choose another one." 결제 대행사의 국가별 지원 설정을 확인하세요.
- "This payment gateway can’t take recurring payments." 정기 결제를 지원하는 대행사를 선택하세요.
- "This payment gateway is coming soon. Use Razorpay, Stripe or PayPal for now, or request it under Request a payment gateway."
자세한 내용은 Error messages: payments 문서를 참고하세요.
자주 묻는 질문
자주 묻는 질문
Which gateway should I use?
인도 독자에게는 Razorpay, 미국·유럽·영국 독자에게는 Stripe, 글로벌 간편결제에는 PayPal이 적합합니다. 국가별로 결제 대행사를 다르게 지정할 수도 있습니다.
Where do I enter my GST details?
판매자 및 GST 탭에서 입력할 수 있습니다. 자세한 내용은 Seller and GST 문서를 참고하세요.