필요한 것
| 필드 | 하는 일 |
|---|---|
| API key | NOWPayments를 호출해 결제를 만들게 합니다. 비밀. |
| IPN secret | 결제 알림이 정말 NOWPayments에서 왔는지 확인합니다. 비밀. |
| Success URL / Cancel URL | 구매자가 결제 후 또는 빠져나간 뒤 도착하는 곳. |
IPN(Instant Payment Notification)은 결제 상태가 바뀔 때 NOWPayments가 보내는 웹훅을 부르는 그들의 이름입니다.
각 필드를 요청하는 이유
API key
결제 생성을 승인해, 자금이 당신의 계정으로 정산됩니다.
IPN secret
들어오는 알림이 진짜 NOWPayments에서 온 것임을 증명해, 아무도 "결제됨" 이벤트를 위조할 수 없게 합니다. API key와는 별개의 값입니다.
Success and Cancel URL
단순한 설정: 구매자가 결제 후 또는 빠져나간 뒤 도착하는 곳. 비밀이 아닙니다.
설정
- 테스트: 샌드박스가 없습니다
NOWPayments에는 샌드박스나 테스트 환경이 없습니다. 처음부터 끝까지 확인하려면, 수수료가 낮은 코인으로 소액 실결제를 보내고 대시보드에 나타나는지 확인하세요. 그 첫 소액 결제를 테스트로 여기세요. NOWPayments 계정은 무료이며, 실결제에서 정상적인 네트워크 및 서비스 수수료만 냅니다.
- NOWPayments에서 결제 설정 열기
account.nowpayments.io에 로그인해 Settings → Payments로 이동하세요. 이 한 화면에서 필요한 세 가지를 모두 찾을 수 있습니다: 지급 지갑(자금이 도착하는 곳), API 키, 그리고 즉시 결제 알림. 각각을 순서대로 확인하세요.
NOWPayments → Settings → Payments - 지급 지갑 추가하기
NOWPayments는 지급 지갑을 등록해야만 API를 사용할 수 있습니다. 지급 지갑에서 새 지갑 추가를 클릭하고, 통화를 선택하고, 내가 관리하는 지갑 주소를 붙여넣은 뒤 지갑 추가를 클릭하세요. 이 주소로 암호화폐가 정산됩니다.
NOWPayments → 지급 지갑 → 새 지갑 추가 - API 키 생성하기
API 키를 열고 새 API 키 추가를 클릭하세요. 생성된 키는 복사 아이콘과 함께 목록에 표시되므로, 언제든 다시 복사할 수 있습니다.
NOWPayments → Settings → API 키 - API 키 복사하기
NOWPayments가 "API 키 생성됨" 대화상자에 새 키를 표시합니다. API key 옆의 복사 아이콘을 클릭해 저장하세요. (아래의 공개 키는 Coin Moebius에 필요하지 않습니다.) 선택적으로 라벨을 추가한 뒤 저장을 클릭하세요.
NOWPayments → API 키 생성됨 이것은 비밀 API 키입니다. 비밀번호처럼 취급하세요.
- IPN 콜백 설정 및 IPN 시크릿 복사하기
즉시 결제 알림을 여세요. IPN(Instant Payment Notification)은 결제 상태가 변경될 때 NOWPayments가 보내는 웹훅을 부르는 그들의 이름입니다.
- Webhook URL 필드에 프로젝트의 NOWPayments 웹훅 주소(아래)를 붙여넣은 뒤 저장을 클릭하세요.
- 상단에 표시된 IPN 시크릿 키를 복사하세요(값이 없으면 재생성을 사용하세요).
- 웹훅 형식 선택에서 Classic way를 선택해 금액과 ID가 일반 숫자 형식으로 유지되도록 하세요.
https://api.coinmoebius.com/webhook/nowpayments/<your project id>NOWPayments → 즉시 결제 알림 프로젝트 ID는 Coin Moebius 대시보드의 프로젝트 이름 아래에 있습니다. 위 주소에 입력하세요. 연결된 제공업체 카드(마지막 단계)에도 같은 URL이 표시되어 언제든 다시 복사할 수 있습니다.
- Coin Moebius로 돌아와 제공업체 추가 → NOWPayments
프로젝트에서 제공업체 탭을 열고, 제공업체 추가를 클릭하고, 서비스 연결을 선택한 뒤 NOWPayments를 고르세요. API 키와 IPN 시크릿을 붙여넣고, Success URL과 Cancel URL(결제 후 또는 취소 시 구매자가 이동할 주소)을 설정한 뒤 저장을 클릭하세요.
Coin Moebius → 제공업체 추가 → NOWPayments - 연결 완료
이제 제공업체 탭에 NOWPayments가 연결 날짜와 함께 표시됩니다. 카드에는 NOWPayments에 붙여넣은 것과 동일한 웹훅 URL과 편집 및 연결 해제 버튼이 있습니다. NOWPayments에는 샌드박스가 없으므로 IPN 시크릿을 자동 검증할 수 없습니다. 대신 카드에서 소액 결제 테스트를 제공하여 처음부터 끝까지 모든 것이 작동하는지 확인할 수 있습니다.
Coin Moebius → 제공업체 → NOWPayments (연결됨)
연결한 후
샌드박스가 없으므로, 당신의 첫 소액 실결제가 테스트입니다:
- 상품을 만들고 당신의 프로젝트를 가리키는 페이지(로컬 HTML 파일도 됩니다)에 구매 버튼을 두세요.
- 수수료가 낮은 코인으로 소액을 결제하세요.
- 거래 탭을 여세요. 새 행의 상태가 succeeded에 도달하면, 당신의 API 키와 IPN 시크릿이 둘 다 처음부터 끝까지 작동하는 것입니다.
문제 해결
결제는 완료되는데 주문이 대기 상태로 남습니다.
IPN이 도착하지 않거나 검증되지 않는 것입니다. 콜백 URL이 일치하는지, 그리고 대시보드의 IPN 시크릿이 NOWPayments 설정의 IPN Secret Key와 일치하는지 확인하세요.
결제 없이 테스트할 방법이 없습니다.
맞습니다, 샌드박스가 없습니다. 진짜 IPN을 발생시키려면 수수료가 낮은 코인으로 소액 실결제를 보낸 뒤, 주문이 업데이트되는 것을 지켜보세요.
상태가 실제 활동에서만 바뀝니다.
NOWPayments 상태는 IPN 전달을 반영하므로, 조용한 계정은 실결제가 움직이기 전까지 상태를 보이지 않습니다.
알아두면 좋은 것
테스트 모드 없음. 샌드박스가 아니라 소액 실결제로 확인하세요.
시크릿 교체. 새 API 키나 IPN 시크릿을 언제든 생성한 뒤 새 값을 붙여넣으세요.
질문이 있으신가요? Join our Discord