쉬운 방법: Stripe으로 로그인
찾아야 할 키도 없고 붙여넣을 것도 없습니다. Stripe에 로그인하고 Coin Moebius을 승인하면 약 1분 후에 다시 돌아옵니다. Coin Moebius은 귀하의 Stripe 계정 ID만 보관하고 키는 보관하지 않으며, Stripe은 귀하의 계정 변경 사항이 발생하는 즉시 우리에게 알려줍니다.
- 공급자를 열고 Connect a provider을 클릭합니다.
Coin Moebius 대시보드의 왼쪽 메뉴에서 공급자를 선택한 다음 오른쪽 상단에서 Connect a provider을 클릭합니다.
Coin Moebius → 제공자 → Connect a provider - Stripe 선택
검색 상자에 Stripe을 입력하거나 아래로 스크롤하여 클릭합니다.
Connect a provider → Stripe - 이름을 지정하고 두 페이지를 추가한 후 저장하세요.
연결에 별명을 지정하십시오. 성공 URL(구매자가 결제 후 표시되는 페이지)과 취소 URL(구매자가 취소할 때 표시되는 페이지)을 입력하세요. 첫 번째 탭에 머물면서 Save and connect with Stripe을 클릭하세요.
닉네임, 성공 URL, 취소 URL → Save and connect with Stripe 두 주소 모두 https://으로 시작해야 합니다. 이 화면에 입력하는 것은 이것뿐입니다.
- Stripe에 승인
Stripe이 열립니다. Stripe 계정에 로그인하거나 아직 계정이 없다면 바로 계정을 만든 다음 Coin Moebius을(를) 승인하세요. Stripe에는 사용하려는 계정이 표시되므로 '예'라고 대답하기 전에 확인할 수 있습니다.
Stripe → 로그인 또는 계정 생성 → Coin Moebius 승인 - 당신이 돌아왔고, 연결되었습니다
Stripe이(가) Coin Moebius로 곧장 보내드립니다. 녹색 확인 표시는 카드 결제가 준비되었음을 의미하며 Stripe 카드는 이제 확인 및 라이브로 표시된 제공자 페이지에 있습니다.
Coin Moebius으로 돌아가기: Stripe 계정이 연결되었습니다. 제공업체 → 귀하의 Stripe 카드: 확인됨, 라이브 녹색 확인 표시 대신 "조치 필요"가 표시되었습니까? Stripe이(가) 귀하의 카드 결제 계정 정리를 완료하지 않았습니다. Stripe 요청을 완료하고 돌아와서 Stripe 카드에서 Verify을(를) 클릭하세요.
다른 방법: 자신만의 키를 붙여넣으세요.
여기서부터 모든 것은 수동 경로입니다. Stripe 대시보드에 웹훅을 설정하고 거기에서 세 개의 값을 수집하여 Coin Moebius에 붙여넣습니다. 10분 정도 계획하세요. 위에서 로그인한 경우 이미 로그인이 완료되었으므로 이 모든 과정을 건너뛸 수 있습니다.
필요한 것
| 필드 | 하는 일 |
|---|---|
| Publishable key (pk_…) | 브라우저에서 Checkout을 여는 공개 키. 비밀이 아닙니다. |
| Secret key (sk_…) | 청구가 당신의 계정을 통해 실행되도록 Checkout 세션을 만들게 합니다. 비밀. |
| Webhook signing secret (whsec_…) | 웹훅이 정말 Stripe에서 왔는지 확인합니다. 비밀. |
| Success URL / Cancel URL | 구매자가 결제 후 또는 빠져나간 뒤 도착하는 곳. |
키 경로에만 이것이 필요합니다. 위의 Stripe로 로그인하신 경우 수집할 내용이 없습니다. Stripe은 테스트 모드와 라이브(pk_test_ / sk_test_ 대 pk_live_ / sk_live_)에 대해 별도의 키를 유지하며 각각 고유한 웹훅 서명 비밀이 있습니다. Coin Moebius은 라이브 탭과 테스트 탭을 모두 보유하므로 테스트 키를 확인하고 나중에 모든 항목을 다시 입력하지 않고도 라이브 키를 추가할 수 있습니다.
각 필드를 요청하는 이유
Publishable key
구매자의 브라우저에서 결제가 열릴 때 당신의 계정을 식별합니다. 설계상 공개입니다.
Secret key
청구 생성을 승인하는 비공개 절반으로, 결제가 당신의 계정을 통해 실행되게 합니다.
Webhook signing secret
들어오는 웹훅이 진짜 Stripe에서 온 것임을 증명해, 아무도 "결제됨" 이벤트를 위조할 수 없게 합니다. secret key와는 별개의 값입니다.
Success and Cancel URL
단순한 설정: 구매자가 결제 후 또는 빠져나간 뒤 도착하는 곳. 비밀이 아닙니다.
설정
- 테스트 모드 사용 (무료)
Stripe 계정은 무료이며, 테스트 모드는 활성화 전에도 작동합니다. dashboard.stripe.com에 로그인해 Test mode(상단 모서리)를 켜세요. 먼저 테스트를 설정한 뒤, 라이브에서 반복하세요.
- 키 복사하기
Developers → API keys로 가서 Publishable key와 Secret key를 복사하세요.
Stripe → Developers → API keys - 웹훅 추가하기
- Developers → Webhooks → Add endpoint.
- 엔드포인트 URL을 당신의 프로젝트 웹훅 주소(아래)로 설정하세요.
- 이벤트를 선택하세요. 일회성 결제의 경우: checkout.session.completed, charge.refunded, charge.dispute.created. 구독을 판매한다면 추가로: customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.payment_succeeded, invoice.payment_failed. 추가 이벤트는 무해합니다. 쓰지 않는 것은 무시합니다.
- 엔드포인트 Signing secret(whsec_…)을 복사하세요. 테스트와 라이브는 각자의 것을 가집니다.
https://api.coinmoebius.com/webhook/stripe/<your project id>Stripe → Developers → Webhooks → Add endpoint - 테스트
테스트 카드는 테스트 모드에서만 작동하며 실제 카드를 절대 청구하지 않습니다. 미래의 만료일, 아무 CVC, 아무 우편번호를 쓰세요.
결과 카드 성공 4242 4242 4242 4242 인증 필요 4000 0025 0000 3155 거절 4000 0000 0000 9995 - 대시보드에서 연결하기
제공업체 추가 → Stripe. publishable key, secret key, webhook signing secret, Success URL, Cancel URL을 입력하세요. 테스트 키로 흐름을 확인한 뒤, 제공업체를 편집해 라이브 키로 바꾸세요.
연결한 후
라이브를 시작하기 전에 한 번만 결제하세요.
- Stripe로 로그인하셨나요? 귀하의 계정이 활성화되어 있으므로 본인의 카드로 1달러짜리 제품을 구입한 후 Stripe으로 환불해 주십시오. 테스트 키를 붙여넣었나요? 모든 결제는 테스트 결제이므로 위에서 테스트 카드를 사용하세요.
- 상품을 만들고 당신의 프로젝트를 가리키는 페이지(로컬 HTML 파일도 됩니다)에 구매 버튼을 두세요.
- 위의 테스트 카드로 결제하세요.
- 거래 탭을 여세요. 새 행의 상태가 succeeded에 도달하면, 당신의 키와 웹훅이 둘 다 처음부터 끝까지 작동하는 것입니다.
테스트 키를 사용한 경우 공급자를 편집하고 라이브 키를 교체하면 실제 결제가 이루어집니다.
문제 해결
Verify으로 시작하세요. 대시보드의 Stripe 카드에서 Verify을 클릭합니다. Stripe에 귀하의 계정에 대해 묻거나 키를 확인하고 문제가 있는 경우 특정 메시지를 반환합니다.
Stripe으로 로그인했는데 "계정이 연결되었습니다. 조치가 필요합니다."라는 메시지가 표시되었습니다.
귀하의 Stripe 계정이 연결되었지만 Stripe이(가) 아직 카드 결제를 승인하지 않았습니다. Stripe을 열고 요청 사항(일반적으로 비즈니스 세부정보 또는 은행 계좌)을 완료한 다음 Coin Moebius의 Stripe 카드에서 Verify을 클릭합니다.
Stripe 카드에 연결 끊김이 표시됩니다.
Coin Moebius은(는) Stripe 계정(일반적으로 Stripe의 승인된 애플리케이션 페이지)에서 제거되었습니다. 카드를 열고 Edit을 선택한 후 Reconnect을 클릭하여 다시 승인하세요.
Verify가 키 형식이 잘못되었다고 합니다.
Secret key는 sk_test_ 또는 sk_live_로 시작합니다(제한된 키는 rk_로 시작). webhook signing secret은 whsec_로 시작합니다. 올바른 값을 올바른 필드에 다시 복사하세요.
Verify가 Stripe가 키를 거부했다고 합니다.
Developers → API keys에서 secret key를 다시 복사하고, 테스트 키를 라이브 웹훅 시크릿과(또는 그 반대로) 짝짓고 있지 않은지 확인하세요.
결제는 완료되는데 주문이 대기 상태로 남습니다.
웹훅이 도착하지 않는 것입니다. 엔드포인트 URL이 정확히 일치하는지, checkout.session.completed를 선택했는지, 그리고 테스트 결제가 테스트 모드 엔드포인트에 닿는지 확인하세요(테스트와 라이브는 별개의 엔드포인트입니다).
서명 검증이 실패합니다.
각 Stripe 엔드포인트는 자기만의 signing secret을 가집니다. 다른 엔드포인트가 아니라 이 엔드포인트 설정의 whsec_를 복사하세요.
처음부터 끝까지 확인하기.
Stripe에는 시뮬레이트 버튼이 없습니다. Stripe Dashboard에서 최근 이벤트를 엔드포인트로 다시 보내거나, 테스트 PaymentIntent를 만든 뒤 주문이 업데이트되는 것을 지켜보세요.
알아두면 좋은 것
Stripe으로 로그인됨. 복사, 저장 또는 회전할 수 있는 키나 웹훅 비밀이 없습니다. Stripe은 계정이 변경되면 Coin Moebius에게 알립니다. 링크를 자르려면 Stripe 카드에서 Disconnect을 클릭하거나 Stripe의 승인된 애플리케이션에서 Coin Moebius을 제거하세요.
키 교체. 자신의 키를 붙여넣으셨나요? 언제든지 비밀 키 또는 웹훅 비밀을 굴린 후 새 값을 붙여넣습니다. 편집 시 비밀 필드는 공백으로 유지되므로 순환된 키를 입력할 수 있습니다.
활성화. 라이브 키는 계정이 결제용으로 활성화된 후에만 작동합니다. 테스트 키는 즉시 작동합니다.
질문이 있으신가요? Join our Discord