필요한 것
| 필드 | 하는 일 |
|---|---|
| API 키 ID | 당신의 MakePay API 키를 식별해 우리가 올바른 계정을 호출하게 합니다. |
| API 키 시크릿 | 우리가 당신의 계정에서 MakePay 결제를 만들게 합니다. 비밀. |
| 웹훅 시크릿 | 웹훅이 정말 MakePay에서 왔는지 확인합니다. 비밀. |
| 성공 URL | 결제 완료 후 구매자가 도착하는 곳. |
| 실패 URL | 결제 실패 또는 취소 후 구매자가 도착하는 곳. |
MakePay는 API 키 ID와 시크릿을 키 생성 시 함께 발급합니다; 웹훅 시크릿은 콜백 설정에서 별도로 얻습니다.
각 필드를 요청하는 이유
API 키 ID
어느 MakePay 키를 사용할지 식별합니다. 혼자서는 비밀이 아니지만 아래의 시크릿과 짝지어집니다.
API 키 시크릿
결제 생성을 승인해, 청구가 당신의 MakePay 계정을 통해 실행되고 당신의 지갑으로 정산됩니다. MakePay는 키 생성 직후 한 번만 보여줍니다.
웹훅 시크릿
들어오는 웹훅이 진짜 MakePay에서 온 것임을 증명해, 아무도 "결제됨" 이벤트를 위조할 수 없게 합니다. API 키와는 별개의 값입니다.
성공 및 실패 URL
단순한 설정: 결제 후 또는 실패/취소 후 구매자가 도착하는 곳. 비밀이 아닙니다.
설정
- MakePay에서 API 키 생성하기
MakePay에 로그인해 API & SDK → API integrations로 갑니다. API keys에서 Generate API Key를 클릭하고 "Coin Moebius" 같은 이름을 지으세요. MakePay는 API 키 ID와 시크릿을 생성 직후 한 번만 보여주므로, 지금 둘 다 복사하세요. 시크릿은 다시 표시되지 않습니다.
MakePay → API & SDK → API integrations → Generate API Key API 키 시크릿을 비밀번호처럼 다루세요. 잃어버렸다면 이전 키를 복구하려 하지 말고 새 키를 생성하세요.
- Coin Moebius 프로젝트 ID 찾기
별도 탭에서 Coin Moebius 대시보드의 당신의 프로젝트를 열고, 프로젝트 이름 아래에서 Project ID를 복사하세요. 당신의 MakePay 콜백 URL은 이 ID를 아래 주소에 넣은 것입니다 — 다음 단계에서 MakePay에 붙여넣을 것입니다.
https://api.coinmoebius.com/webhook/makepay/<your project id>Coin Moebius → your project → Project ID 연결된 제공업체 카드(마지막 단계)도 같은 URL을 보여주므로, 언제든 다시 복사할 수 있습니다.
- 콜백 URL 설정 및 웹훅 시크릿 복사하기
MakePay로 돌아가 Delivery → Callback URL configuration으로 스크롤하세요. Edit Callback URL을 클릭해 당신의 Coin Moebius 웹훅 URL을 활성 목적지로 붙여넣고 저장하세요. 그 다음, Webhook signing에서 서명 시크릿을 복사하세요(값이 없으면 Regenerate secret 사용) — 그것이 Coin Moebius가 요청하는 웹훅 시크릿입니다.
MakePay → Delivery → Callback URL configuration MakePay는 모든 가판인이 보는 상태 변화 후 이 주소로 전달 업데이트를 게시합니다. 서명 시크릿은 API 키와 별개이므로 둘 다 필요합니다.
- Coin Moebius 대시보드에서 연결하기
Coin Moebius에서 제공업체 추가 → MakePay를 엽니다. 당신의 API 키 ID, API 키 시크릿, 웹훅 시크릿을 붙여넣고, 성공 URL과 실패 URL을 설정하세요(결제 후 또는 실패 후 구매자가 도착하는 곳). 저장을 클릭하세요.
Coin Moebius → Add provider → MakePay 저장된 시크릿은 숨겨진 상태로 유지됩니다. 나중에 변경하려면 Replace를 선택해 새 값을 입력하세요.
- 연결 완료
MakePay가 이제 당신의 제공업체 탭에 연결 날짜와 기대하는 웹훅 URL과 함께 표시됩니다. 아직 하지 않았다면, 그 URL을 MakePay의 콜백 설정에 붙여넣으세요. 편집으로 키를 교체하거나 연결 해제로 제거할 수 있으며, 테스트 모드 토글로 실제 수치에 영향을 주지 않고 주문을 진행하세요.
Coin Moebius → Providers → MakePay (connected)
연결한 후
정식 오픈 전에 주문을 한 번 끝까지 진행하세요:
- 연결된 MakePay 카드에서 테스트 모드 토글을 켜 실제 수치에 영향을 주지 않고 주문을 진행하세요.
- 상품을 만들고 당신의 프로젝트를 가리키는 페이지(로컬 HTML 파일도 됩니다)에 구매 버튼을 두세요.
- MakePay를 통해 결제를 완료하세요.
- 거래 탭을 여세요. 새 행의 상태가 succeeded에 도달하면, 당신의 키와 웹훅이 둘 다 처음부터 끝까지 작동하는 것입니다.
실제 결제 준비가 되면 테스트 모드를 끕니다.
문제 해결
대시보드부터 시작하세요: MakePay 카드가 연결되어 있고 웹훅 URL이 MakePay에 저장된 콜백 목적지와 일치하는지 확인하세요.
결제는 완료되는데 주문이 대기 상태로 남습니다.
웹훅이 도착하지 않거나 검증되지 않은 것입니다. MakePay의 콜백 URL이 당신의 프로젝트 웹훅 URL과 정확히 일치하는지, 그리고 Coin Moebius의 웹훅 시크릿이 MakePay의 서명 시크릿과 일치하는지 확인하세요.
제공업체 저장이 거부됩니다.
API 키 ID, API 키 시크릿, 웹훅 시크릿이 모두 필수입니다. MakePay에서 다시 복사하세요 — 시크릿은 한 번만 표시되므로, 더 이상 없다면 새 키를 생성하세요.
테스트 주문이 거래 탭에 나타나지 않습니다.
MakePay 카드의 테스트 모드 토글을 구매 버튼을 실행하기 전에 켜야 하며, 상품이 같은 프로젝트를 가리키는지 확인하세요.
알아두면 좋은 것
비보관형. MakePay는 암호화폐를 곧장 당신의 지갑으로 정산합니다. Coin Moebius는 절대 자금을 보관하지 않으며 옮길 수 없습니다.
시크릿 교체. 새 API 키나 웹훅 서명 시크릿을 언제든 생성한 뒤 대시보드에서 Replace를 선택해 새 값을 붙여넣으세요. 시크릿 필드는 편집 시 비어 있습니다.
질문이 있으신가요? Join our Discord