Razorpay, Stripe, PayPal에 웹훅 결제 주소를 넣는 방법

위치: 설정 → 독자 및 수익 → 연동 → 결제

이 페이지 열기: admin.<your-site>/settings/connections/payments (<your-site> 부분을 내 사이트 주소로 변경)

시작 전 확인사항

• 먼저 Razorpay, Stripe, PayPal 중 사용할 서비스를 연동하세요. 결제 가이드를 참고하세요.
• 사이트 소유자 계정으로 로그인해야 합니다.

진행 방법

Stripe 및 PayPal: Keynate가 가능한 경우 계정 내 결제 알림을 자동으로 설정해 드립니다. 설정 완료 시 카드에 "Stripe에 결제 알림이 자동으로 설정되었습니다."라고 표시됩니다. 자동 설정이 불가능한 경우 "한 단계 더 남았습니다"라는 문구와 설정 완료 버튼이 표시됩니다. 아래 순서대로 직접 진행해 주세요.

Razorpay: 자동으로 설정되지 않습니다. Razorpay 카드에는 실시간 확인 기능이 포함된 3단계 안내 상자가 표시됩니다. 테스트든 실제든 첫 결제가 이루어지면 Razorpay의 첫 메시지를 기다리는 중… 문구가 Razorpay의 첫 메시지를 받았습니다.로 변경됩니다. 지금 확인을 눌러 다시 확인할 수 있습니다. 자세한 내용은 Razorpay 연동하기를 참고하세요.

모든 결제대행사 공통 설정 방법:

1. 설정 → 독자 및 수익 → 연동 → 결제을 엽니다.
2. 이용 중인 결제대행사 카드에서 Webhook 상자를 찾습니다.
3. 웹훅 열기를 누릅니다(버튼 이름에 대행사 이름이 표시됨). 새 탭에서 대행사 대시보드가 열립니다.
4. 결제대행사 화면에서 추가을 누릅니다.
5. 다시 Keynate로 돌아와 웹훅 URL 옆의 복사을 누른 뒤, 대행사 화면에 붙여넣습니다.
6. Keynate 상자에 나열된 이벤트 항목을 대행사 화면에서 체크합니다.
7. Razorpay: 보안 코드 옆의 복사을 누르고 비밀번호(secret) 란에 붙여넣습니다. 테스트 모드와 라이브 모드에는 각각 서로 다른 비밀번호를 사용해야 합니다.
8. 결제대행사에서 설정을 저장합니다.
9. Stripe와 PayPal은 저장 후 코드가 화면에 나타납니다. Stripe에서는 이를 서명 비밀번호(signing secret)라고 부르며 whsec_로 시작합니다. PayPal에서는 Webhook ID라고 부릅니다. 이 값을 복사하여 Keynate의 해당 입력란에 붙여넣으세요.
10. 연결 테스트을 누릅니다.

참고 사항

• 테스트 모드와 라이브 모드는 각각 별도의 웹훅 설정이 필요합니다.
• 비밀번호를 잊어버린 경우, 결제대행사에서 웹훅을 새로 추가하고 새 코드를 붙여넣으세요.

자주 발생하는 문제

• "Razorpay에 입력한 웹훅 비밀번호를 붙여넣으세요." Keynate 입력란이 비어 있습니다. Razorpay에 입력했던 것과 동일한 비밀번호를 붙여넣으세요.
• "테스트 모드와 라이브 모드에는 서로 다른 웹훅 비밀번호를 사용하세요." 두 번째 모드용으로 새로운 비밀번호를 만들어 입력하세요.
• "웹훅 서명 비밀번호를 붙여넣으세요. whsec_로 시작합니다." 엔드포인트를 추가한 후 Stripe에서 해당 코드를 복사해 오세요.
• "Webhook ID를 붙여넣으세요(영문과 숫자만 가능)." PayPal 앱의 Webhooks 목록에서 해당 ID를 복사해 오세요.
• Razorpay에 여전히 "Razorpay의 첫 메시지를 기다리는 중…"이라고 표시되는 경우: 소액 테스트 결제를 진행해 보세요. 첫 결제가 발생해야 메시지가 전송됩니다. 결제 후 지금 확인을 누르세요.
• 독자가 결제했는데도 주문이 계속 미결제 상태로 남아 있는 경우: 웹훅이 설정되지 않았거나 잘못 입력되었습니다. Keynate는 매일 밤 결제대행사와 주문 내역을 자동으로 대조하여 누락된 주문을 정상 처리합니다.

자주 묻는 질문

관련 도움말

• Razorpay 연동
• Stripe 연동하기
• PayPal 연동
• 테스트 결제하기
• 결제