blockwallets로 이전하기
blockwallets에는 세 게이트웨이용 호환 API가 있습니다. 아래에서 해당하는 것을 찾으세요. 표에는 바꿔야 하는 것만 정리해 두었습니다.
바꿔야 하는 것
| 이전 서비스 | 이전 | 이후 | 새 자격 증명 | 웹훅 서명 | |
|---|---|---|---|---|---|
| Cryptomus | https://api.cryptomus.com | https://blockwallets.io | merchant + API key | 본문의 sign 필드, md5(base64(…) + API key) | 전체 가이드 → |
| NOWPayments | https://api.nowpayments.io/v1 | https://blockwallets.io/nowpayments/v1 | API key + IPN secret | x-nowpayments-sig (HMAC-SHA512) | 전체 가이드 → |
| Coinbase Commerce | https://api.commerce.coinbase.com | https://blockwallets.io/coinbase/ | API key + webhook shared secret | X-CC-Webhook-Signature (HMAC-SHA256) | 전체 가이드 → |
blockwallets는 Cryptomus 호환 API 외에 NOWPayments 호환 API와 Coinbase Commerce 호환 API도 제공합니다. 경로, 인증 헤더, 요청 / 응답 필드, 상태, 웹훅 서명이 각사의 공식 문서를 따르므로 기존 코드는 대개 새 기본 URL과 새 키만 있으면 됩니다. Coinbase Commerce는 2026-03-31부터 미국과 싱가포르 밖의 가맹점에 서비스를 제공하지 않으니 바로 옮기셔도 됩니다.
내부적으로는 일반 blockwallets 청구서입니다. 수신 주소는 당신의 것이고, 결제 페이지는 저희가 호스팅하는 결제 페이지이며, 결제는 체인에서 컨펌되고 두 번째 노드와 교차 확인된 뒤에야 인정됩니다. 아래에서 세 단계를 설명하고, 이어서 각 API가 지원하는 범위와 원래 서비스와 어떻게 다른지를 설명합니다. 구현하지 않은 매개변수는 조용히 무시하지 않고 오류를 돌려줍니다.
테스트 모드
테스트 자격 증명으로 만든 charge와 결제는 각 체인의 테스트넷에서 동작하며 웹훅은 테스트 IPN secret / 공유 시크릿으로 서명됩니다. 실서비스와 완전히 분리되어 있어 테스트 키로는 실서비스 결제를 볼 수 없습니다.
나머지(결제 페이지, 컨펌, 네트워크와 최소 금액, 환불)는 메인 문서와 같습니다.