문서

blockwallets에서는 USDT와 USDC는 물론 BTC, LTC, 각 체인의 기본 코인도 받을 수 있습니다(고정한 환율로 미국 달러로 입금 처리). 아래 어떤 연동 방식이든 같은 호스팅 결제 페이지에 같은 종류의 청구서가 만들어지고, 컨펌 수, 수수료, 잔액도 같습니다. 달라지는 것은 당신의 시스템이 저희와 통신하는 방식뿐입니다. 맞는 방식을 골라 해당 페이지를 따라가세요.

연동 방식 고르기

지금 상황에 따라 나눠 두었습니다. 카드를 열면 전체 가이드가 나옵니다.

코드 없음

가맹점 관리 화면에서 바로 결제를 받습니다. 설치할 것이 없습니다.

새 API 연동

연동을 처음부터 직접 만드는 경우입니다.

다른 게이트웨이에서 이전

코드는 그대로: 호환 API라서 기본 URL과 키만 바꾸면 됩니다.

AI에게 연동 맡기기

코드를 직접 쓰지 않고 AI 코딩 도구를 쓰는 분을 위한 방법입니다.

도구

브라우저에서 실행되는 디버깅 도구입니다.

Cryptomus 호환 vs 네이티브

둘 다 같은 결제 페이지에 같은 청구서를 만들며 수수료와 잔액도 같습니다. 다른 점은 요청 방식, 웹훅 형식, 자격 증명을 받는 방법입니다.

새로 시작한다면 네이티브 REST API를 권장합니다: 센트 단위 금액, 멱등한 ref, 타임스탬프가 포함된 웹훅 서명, 그리고 관리 화면에서 직접 생성하는 키. 이미 Cryptomus를 쓰고 있거나 기존 Cryptomus SDK·플러그인을 그대로 쓰고 싶다면 Cryptomus 호환 API를 쓰세요.

빠른 시작

아무것도 없는 상태에서 테스트 결제까지 다섯 단계입니다(Cryptomus 호환 API 기준이며, 다른 API도 각자의 자격 증명으로 같은 순서를 따릅니다).

1. 홈페이지에서 이용을 신청하세요. 승인되면 가맹점 관리 화면에 로그인합니다.
2. 관리 화면의 “개발자 › 연동 및 키”를 열고 Test 열에서 merchant와 API key를 생성한 뒤 웹사이트 도메인을 추가합니다.
3. 서버에서 POST /v1/payment로 청구서를 만들고 고객을 result.url로 리디렉션합니다.
4. 결제 페이지의 “결제 시뮬레이션”으로 결제한 뒤, 웹훅 핸들러가 sign을 검증하고 payment_amount_usd 기준으로 입금 처리하는지 확인합니다.
5. Live 열의 자격 증명으로 바꾸고 소액을 실제로 한 번 결제해 보세요(관리 화면 홈의 “한 건 시험 결제”).

POST https://blockwallets.io/v1/payment
merchant: <merchant>
sign: md5(base64(body) + API key)
Content-Type: application/json

{
  "amount": "42.00",
  "currency": "USD",
  "order_id": "order_1042",
  "url_callback": "https://shop.example/webhooks/crypto",
  "url_return": "https://shop.example/cart",
  "url_success": "https://shop.example/thanks?order=1042"
}

단계별 Node.js, PHP, Python 코드는 Cryptomus 호환 API 문서에 있습니다. AI에게 맡기고 싶다면 프롬프트 생성기부터 시작하세요.

결제 링크 (코드 없음)

가맹점 관리 화면 → “결제 › 결제 링크” → 설명과 금액 입력(네트워크를 고정하거나 고객이 고르게 함) → 만들기. 링크마다 URL과 QR 코드가 생깁니다.

• 링크를 열 때마다 새 청구서가 만들어지므로 링크 하나를 계속 재사용할 수 있습니다(예: “회원권 $99”).
• 모든 결제는 “결제 › 결제 내역” 아래에 표시되고, “자금 › 잔액과 출금”에서 내 지갑으로 출금합니다.
• “개발자 › 연동 및 키”에서 자격 증명과 웹훅 URL을 만들어 두었다면, 링크로 들어온 결제도 Cryptomus 호환 웹훅 형식으로 알려 드립니다.
• 받기를 멈추려면 “비활성화”를 누르세요. 링크는 즉시 작동을 멈춥니다.

매장용 POS

카운터와 노점용입니다: 가맹점 관리 화면 → “결제 › POS 계산대” → 단말기를 열고 POS 링크를 받으세요. 직원이 휴대폰이나 태블릿에서 열어 금액을 입력하면 결제 QR 코드가 나타나고, 고객이 결제하면 화면에 “Paid”가 표시됩니다.

• POS 청구서는 30분 동안 유효합니다. 결제금은 잔액에 들어가 “결제 › 결제 내역”에 표시되며, 결제 링크와 마찬가지로 웹훅 URL로 알림이 갑니다.
• POS 링크로는 결제 접수만 할 수 있습니다. 잔액, 출금, 다른 주문, 설정, 자격 증명은 볼 수 없습니다.
• 기기를 분실했거나 직원이 그만두었나요? 관리 화면에서 해당 단말기를 해지하면 그 링크는 즉시 작동하지 않습니다.

버튼 삽입

가맹점 관리 화면 → “결제 › 결제 링크” → “버튼 삽입”: 문구, 색상, 크기, 모양을 고르고 코드 조각을 복사하세요. 버튼을 클릭하면 해당 결제 링크의 결제 페이지가 열립니다.

• 순수 HTML: 스크립트 없는 스타일 적용 링크 하나이므로 HTML을 붙여 넣을 수 있는 곳이면 어디서든 동작합니다(사이트 빌더, 포럼, 이메일 서명 등).
• 스크립트 사용: data-blockwallets와 /embed.js 태그 하나를 추가합니다. 데스크톱에서는 결제 페이지가 가운데의 작은 창으로 열리고, 휴대폰에서는 일반적으로 열립니다.
• 스크립트는 요청을 보내지 않고, 쿠키를 설정하지 않으며, iframe도 추가하지 않습니다. 페이지가 스크립트를 막아도 버튼은 정상적으로 작동하는 일반 링크로 남습니다.

아래 코드의 /l/pl_…를 직접 만든 결제 링크 주소로 바꾸세요.

순수 HTML

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   style="display:inline-flex;align-items:center;height:44px;padding:0 22px;border-radius:999px;background:#1f5a3d;color:#ffffff;font:600 16px/1 sans-serif;text-decoration:none">Pay with crypto</a>

HTML + 스크립트

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   data-blockwallets data-color="green" data-size="m" data-shape="pill">Pay with crypto</a>
<script src="https://blockwallets.io/embed.js" async></script>