BIP21 비트코인 URI

다른 이름: bitcoin: URI, 비트코인 결제 URI, BIP 21

정의

BIP21 비트코인 URI는 bitcoin:으로 시작하며 비트코인 주소와 선택 사항인 금액, 라벨, 메시지를 담은 링크예요. QR코드에 쓰면 지갑이 결제 정보를 미리 채워 줘요.

BIP21이 정의하는 것

BIP21은 2012년에 Nils Schneider와 Matt Corallo가 작성한 비트코인 개선 제안(Bitcoin Improvement Proposal)으로, 비트코인 결제를 위한 URI 스킴을 정의해요. URI는 bitcoin:으로 시작하고 수취 주소와 선택 사항인 쿼리 매개변수가 뒤따라요. 지갑이 이런 URI가 담긴 QR코드를 스캔하면 주소와 금액이 이미 채워진 송금 화면이 열려요.

금액은 더 작은 단위가 아니라 비트코인 단위의 십진수로 써요. 예를 들어 bitcoin:bc1q...?amount=0.001&label=Maple%20Street%20Bakery&message=Order%2042는 0.001 BTC를 요청해요. label과 message의 텍스트 값은 퍼센트 인코딩해요.

  • amount: 요청 금액, BTC 단위의 십진수
  • label: 수취인 이름
  • message: 결제를 설명하는 메모
  • req-로 시작하는 매개변수는 지갑이 이해해야 하며, 그렇지 않으면 URI를 거부해야 해요

QR코드에서 BIP21 쓰기

QR코드에는 주소만 담을 수도 있고 전체 BIP21 URI를 담을 수도 있어요. URI에는 금액과 스킴이 들어 있어서 휴대폰이 지갑을 열어야 한다는 걸 알기 때문에, 결제에는 URI가 더 유용해요. 일부 지갑은 라이트닝 인보이스 같은 추가 매개변수를 더하는데, 이는 원래 BIP21 문서에 없는 관례이고 모든 지갑이 읽는 것은 아니에요.

보내기 전에는 항상 지갑에 표시된 주소를 확인하세요. 비트코인 거래는 되돌릴 수 없고, 진짜 코드 위에 덧붙인 코드는 자금을 다른 사람에게 보낼 수 있어요.

자주 묻는 질문

비트코인 QR코드의 금액은 어떤 단위인가요?

BIP21 URI에서 amount 매개변수는 amount=0.001처럼 비트코인(BTC) 단위의 십진수예요.

QR코드에는 비트코인 주소만 있어도 되나요?

대부분의 지갑에서 주소만으로도 작동하지만, bitcoin: URI는 금액과 메모도 담을 수 있고 이 코드가 결제 요청임을 알려 줘요.

출처와 표준

모든 용어