Dodo Payments 연결하기

필요한 것

필드	하는 일
API key	Dodo를 호출해 호스팅 결제를 만들게 합니다. 비밀.
Webhook signing secret (whsec_…)	웹훅이 정말 Dodo에서 왔는지 확인합니다. 비밀.
Return URL	구매자가 결제 후 도착하는 곳.

호스팅 결제 생성을 승인해, 청구가 당신의 계정을 통해 실행됩니다.

들어오는 웹훅이 진짜 Dodo에서 온 것임을 증명해, 아무도 "결제됨" 이벤트를 위조할 수 없게 합니다. API key와는 별개의 값입니다.

단순한 설정: 구매자가 결제 후 도착하는 곳. 비밀이 아닙니다.

테스트 모드 사용 (무료)
Dodo는 별도의 테스트 환경을 가집니다. 테스트 모드 키는 Dodo 테스트 호스트에 대해 실행되며, 실제 돈은 움직이지 않습니다.
1. app.dodopayments.com에 로그인하세요.
2. Dodo는 Live 키와 Test 키를 분리합니다. 먼저 테스트를 설정한 뒤, 라이브에서 반복하세요.
API 키 복사하기
Developer → API Keys로 가서 확인용 Test 키, 또는 실결제용 Live 키를 복사하세요.
Dodo → Developer → API Keys
웹훅 추가하기
1. Dodo에서 웹훅을 추가하세요.
2. 웹훅 URL을 당신의 프로젝트 웹훅 주소(아래)로 설정하세요.
3. webhook signing secret(whsec_…)을 복사하세요. 테스트와 라이브에 별도의 웹훅을 추가하세요.
```
https://api.coinmoebius.com/webhook/dodopayments/<your project id>
```
Dodo → Developer → Webhooks
대시보드에서 연결하기
제공업체 추가 → Dodo Payments. Return URL과 Live 그룹(Live API key, Live webhook signing secret)을 입력하세요. 먼저 확인하려면 선택형 Test 그룹을 추가하세요. Test 그룹은 한 쌍입니다. 테스트 API 키와 테스트 웹훅 시크릿을 둘 다 추가하거나, 둘 다 비워두세요. 라이브와 테스트는 따로 확인됩니다.

정식 오픈 전에 테스트 결제를 한 번 실행하세요:

상품을 만들고 Environment를 Testing으로 설정하세요. 그러면 상품이 당신의 테스트 자격 정보로 실행되어, 돈을 움직이지 않고 전체 주문을 넣을 수 있습니다. (테스트 세트를 건너뛰었다면 Testing 상품이 라이브로 폴백되니, 먼저 추가하세요.)
당신의 프로젝트를 가리키는 페이지(로컬 HTML 파일도 됩니다)에 구매 버튼을 두세요.
Dodo의 테스트 모드에서 결제를 완료하세요.
거래 탭을 여세요. Testing 태그가 붙은 새 행이 나타납니다. 상태가 succeeded에 도달하면, 당신의 자격 정보와 웹훅이 둘 다 처음부터 끝까지 작동하는 것입니다.

실제 결제 준비가 되면 상품 Environment를 Live로 전환하세요.

Verify로 시작하세요. 대시보드에서 Verify(또는 Verify test credentials)를 클릭해 API 키를 확인하세요.

Test 탭에서 테스트 API 키를 추가하고, 제공업체를 저장한 뒤, 대화상자를 다시 열어 확인하세요.

웹훅 URL이 일치하는지, 그리고 signing secret이 같은 환경의 웹훅과 일치하는지(테스트에는 테스트 시크릿, 라이브에는 라이브) 확인하세요.

Test 그룹은 한 쌍입니다. 테스트 API 키와 테스트 웹훅 시크릿을 둘 다 추가하거나, 둘 다 비워두세요.

당신의 웹훅 URL을 가리키는 Dodo Dashboard → Developer → Webhooks → Send Example(또는 Dodo CLI), 그런 다음 주문이 업데이트되는 것을 지켜보세요.

일회성 결제 전용. Coin Moebius는 Dodo를 구독이 아니라 단일 결제에 씁니다.

시크릿 교체. API 키나 웹훅 시크릿을 언제든 갱신한 뒤 새 값을 붙여넣으세요. 비밀 필드는 편집 시 비어 있습니다.

질문이 있으신가요? Join our Discord