텔레그램 봇
실물 상품, 현실 세계의 서비스, 자체 사이트 판매에는 13개 코인을 모두 사용할 수 있습니다. 텔레그램 안에서 판매하는 디지털 상품은 계속 텔레그램 Stars를 사용합니다.
원샷 연동
텔레그램 봇과 암호화폐 서비스를 위한 암호화폐 결제 게이트웨이
텔레그램 봇에서 API 키와 연동 프롬프트를 받으세요. 프롬프트를 AI 코딩 에이전트에 붙여넣으면 바로 암호화폐 결제를 받을 수 있습니다. API 문서를 읽을 필요가 없습니다.
3단계로 연결하기
텔레그램 봇을 열면 몇 초 만에 API 키와 AI 코딩 에이전트용 연동 프롬프트를 받습니다.
Claude Code, Cursor 등 AI 코딩 에이전트가 저희 문서를 읽고 결제 링크, 웹훅, 서명 검증까지 연동 코드를 작성합니다.
온체인에서 결제를 확인하고 가짜 코인을 차단한 뒤, 서버로 서명된 웹훅을 보냅니다. 이제 주문을 출고하세요.
지원 코인
USDT, USDC, BTC, ETH, GRAM 등 13개 코인으로 암호화폐 결제 받기
12개 네트워크의 13개 코인
- AVAX
- BNB
BTC
DOGE- ETH
- GRAM
LTC- POL
SOL- TRX
- USDC
- USDT
XMR
지원 네트워크: Tron (TRC-20) · TON · Ethereum (ERC-20) · BNB Chain (BEP-20) · Solana · Polygon · Base · Avalanche C-Chain · Bitcoin · Litecoin · Dogecoin · Monero
구매자는 어떤 지갑으로든 결제
구매자에게 결제 링크를 보내면 됩니다. 구매자는 마감 전에 아무 지갑에서나 정확한 금액을 결제하고, 서버에는 서명된 웹훅이 도착합니다.
구매자는 어떻게 결제하나요?Telegram
텔레그램 봇, 미니 앱, 암호화폐 서비스를 위해 만들었습니다.
API 키 하나로 세 가지 모두 사용할 수 있습니다. 어디에 어떤 코인을 보여 줄 수 있는지는 텔레그램 정책이 정하며, 체크아웃은 이를 따릅니다.
미니 앱
텔레그램은 미니 앱에서 TON 코인만 허용하므로, 체크아웃에는 고객님의 도메인에서 TON 기반 GRAM과 USDT가 표시됩니다.
암호화폐 서비스와 웹사이트
8개 네트워크의 USDT, 5개 네트워크의 USDC, 그리고 BTC, ETH, GRAM 등 13개 코인을 결제 링크, 서명된 웹훅, 직접 승인하는 출금과 함께 API 하나로 받으세요.
텔레그램 봇에서 암호화폐 결제를 받는 방법
결제는 호출 한 번, 출고는 웹훅 한 번.
API 호출 한 번으로 암호화폐 결제 링크를 만드세요. 온체인에서 입금이 확인되면 서명된 웹훅으로 서버에 딱 한 번 알려 드립니다. 노드 운영도, 폴링도, 양식도 필요 없습니다.
연동은 이게 전부입니다
Ravelo Bot
봇
/start테스트 API 키가 준비되었습니다:
rvk_test_8f3k…x9Kp
2단계
호출 한 번
금액과 주소가 각각 지정된 결제 링크를 만드세요. 채팅, 이메일, 자체 사이트에서 보낼 수 있습니다.
POST /v1/payment-intentsPOST /v1/payment-intents { "order_ref": "1042", "asset_id": "usdt-tron", "amount": "25000000" // 25 USDT } 201 Created { "status": "requires_payment", "instructions": { "address": "TQ7a…3fK" } }3단계
구매자가 결제
아무 지갑에서나 마감 전에 정확한 금액을 QR 코드로 결제합니다.
주문 #1042
14:5925.00 USDT
TQ7a…3fK · TRON (TRC-20)
12:30까지 결제하세요
4단계
웹훅 한 번
온체인에서 결제를 확인하고 가짜 코인을 차단한 뒤, 서버로 서명된 웹훅을 보냅니다. 이제 주문을 출고하세요.
webhookPOST https://your-bot.app/webhook ravelo-signature: verified { "type": "payment_intent.succeeded", "data": { "order_ref": "1042", … } }이제 주문을 출고하면 끝입니다.
개발자
암호화폐 결제 API 하나로, SDK와 검증 가능한 웹훅까지.
REST API와 TypeScript, Python SDK, 퀵스타트 문서, 테스트 모드를 제공합니다. 모든 웹훅에 서명이 붙어 있어 서버에서 저희가 보낸 것임을 검증할 수 있습니다. 키로는 결제 생성과 출금 준비만 가능하며, 자금이 나가는 것을 승인할 수 있는 사람은 고객님뿐입니다.
자금을 빼낼 수 없는 키
API 키로는 결제 생성과 출금 준비만 할 수 있습니다. 자금을 내보낼 수는 없습니다. 송금에는 직접 승인이 필요합니다.
안전하게 재시도 가능
같은 멱등성 키로 같은 요청을 두 번 보내도 결제는 두 건이 아니라 한 건만 생성됩니다.
모든 호출을 기록
API와 MCP 호출은 모두 기록됩니다. 어떤 키로, 어떤 도구로, 무엇을 요청했는지 확인할 수 있습니다.
결제 링크 생성
import { Ravelo } from "@ravelo/sdk";
const ravelo = new Ravelo({
apiKey: process.env.RAVELO_TEST_KEY,
baseUrl: process.env.RAVELO_API,
});
// 25 USDT on TRON, in base units (6 decimals)
const intent = await ravelo.paymentIntents.create({
order_ref: "1042",
asset_id: "usdt-tron",
amount: "25000000",
});
console.log(intent.instructions.address); // send your buyer here
웹훅 검증
import { verifyWebhook } from "@ravelo/sdk";
// Verify the raw bytes exactly as they arrived
const event = await verifyWebhook(
rawBody,
req.headers["ravelo-signature"],
process.env.RAVELO_WEBHOOK_SECRET,
); // throws if the body or signature was forged
if (event.type === "payment_intent.succeeded") {
ship(event.data.order_ref);
}
AI 코딩 에이전트
프롬프트 하나로 연동도 끝.
봇이 보내 준 연동 프롬프트를 AI 코딩 에이전트에 붙여넣기만 하면 됩니다.
Claude Code, Cursor 등 AI 코딩 에이전트가 저희 문서를 읽고 결제 링크, 웹훅, 서명 검증까지 연동 코드를 작성합니다. MCP 서버를 연결하면 AI 어시스턴트가 결제 링크를 만들고 결제 상태를 확인할 수도 있습니다. 출금을 승인하는 일은 없습니다. 승인은 직접 하는 것입니다.
봇이 보내 주는, AI 코딩 에이전트에 바로 붙여넣을 수 있는 프롬프트:
Integrate Ravelo crypto payments
into this project.
API key (test): rvk_test_••••
1. Read the docs: https://ravelopay.app/llms.txt
2. Add a /buy command that creates a
payment link with one API call.
3. Add a webhook that checks the
signature and ships the order.
4. Run one test payment.
보안
모든 결제를 검증하므로 가짜 입금으로 출고할 일이 없습니다.
주문마다 전용 결제 링크와 체크아웃 페이지가 만들어집니다. 암호화폐 또는 법정화폐 기준 가격으로 정확한 금액, QR 코드, 마감 시간을 보여 줍니다.
가짜 코인 차단
검증된 토큰 컨트랙트의 코인만 입금으로 인정합니다. 가짜 토큰으로 주문이 결제 완료 처리되는 일은 없습니다.
부족 입금, 지연 입금, 다른 코인 입금까지 처리
무엇이 언제 도착했는지 주문 화면에서 정확히 확인할 수 있습니다. 전액이 입금되기 전에는 출고 가능 상태가 되지 않습니다.
결제 완료 후 출고 가능
상태를 둘로 나누었기 때문에 자금이 확정된 뒤에만 코드가 출고를 진행합니다. 감사 페이지를 방문했다고 해서 결제로 인정되지 않습니다.
노드를 운영할 필요 없음
12개 네트워크를 모두 저희가 모니터링합니다. 결제에 변동이 있을 때만 서버로 알려 드립니다.
출금
직접 승인하는 출금
자금은 고객님이 지시할 때만 나갑니다.
저장된 주소로 출금하세요. 새 주소는 입금을 받을 수 있게 되기까지 24시간 대기합니다. 백엔드나 AI 어시스턴트가 출금이나 환불을 준비할 수는 있지만, 지문, 얼굴 또는 보안 키로 직접 승인하기 전에는 자금이 움직이지 않습니다.
대시보드
모든 결제, 잔액, 출금을 한곳에서.
API로 결제 링크를 만들거나, 그 위에 직접 체크아웃을 구축하세요. 모든 결제가 하나의 대시보드에 모여 결제부터 출금까지 추적됩니다.
Ravelo/지갑 및 결제실시간 잔액
총 가치
US$9,640.62
USD 기준, 1시간 단위 가격
사용 가능
US$9,315.62
출금 가능
대기 중
US$250.00
온체인에서 확인 중
보류 중
US$75.00
주소 24시간 대기
최근 결제 및 출금상태
- ✓ 출고 가능
+25.00 USDT
주문 #1042 · TRON (TRC-20)
- ✓ 출고 가능
+140.00 USDT
주문 #1041 · TON
- 출금 완료
−450.00 USDT
출금 · 저장된 지갑
- ✓ 출고 가능
+0.42 ETH
주문 #1039 · Ethereum
결제별 상태
결제 완료, 출고 가능, 출금 완료 상태를 도착한 송금별로 확인합니다.
CSV 명세서
결제와 출금 내역을 CSV로 내보내 세무 담당자에게 전달하세요.
팀 역할
공동 창업자나 개발자를 초대하세요. 각 멤버는 역할에 허용된 내용만 보고 실행할 수 있습니다.
코인별 잔액
사용 가능, 대기 중, 보류 중인 잔액을 따로 보여 줍니다. 출금할 수 있는 금액을 항상 알 수 있습니다.
전액 또는 부분 환불
주문 금액의 전부 또는 일부를 확인된 주소로 환불합니다. 환불 합계가 구매자의 결제 금액을 넘을 수는 없습니다.
테스트 키와 라이브 키
테스트 모드에서 개발한 뒤 라이브 키로 전환하세요. 테스트 결제로 실제 돈이 움직이는 일은 없습니다.
요금
요금: 결제 건당 3%, 설정 비용과 월 이용료 없음
- 구매자가 100 USDT를 결제하면 97 USDT를 받습니다
- 설정 비용도 월 이용료도 없음
- 테스트 모드는 무료
- 출금 때마다 네트워크 비용을 미리 표시
자주 묻는 질문
암호화폐 결제 게이트웨이 자주 묻는 질문
개발자분들이 연동 전에 자주 묻는 질문입니다. 궁금한 점이 없다면 텔레그램으로 문의하세요.
텔레그램 봇에서 몇 초 만에 API 키를 받고, AI 코딩 에이전트용 연동 프롬프트도 함께 받습니다. API 호출 한 번이면 테스트 모드에서 첫 결제 링크가 만들어집니다. 라이브 결제는 계정이 활성화되는 즉시 시작됩니다.
Claude Code나 Cursor 같은 AI 코딩 에이전트에 줄 수 있는 바로 쓸 수 있는 지시문입니다. 봇이 API 키와 함께 보내 드립니다. 붙여넣으면 에이전트가 프로젝트에 결제 링크와 검증된 웹훅을 추가합니다. 그다음 테스트 결제를 진행하면 됩니다.
Tron (TRC-20), TON, Ethereum (ERC-20), BNB Chain (BEP-20), Solana (SPL), Polygon, Base, Avalanche C-Chain의 USDT. Ethereum (ERC-20), Solana (SPL), Polygon, Base, Avalanche C-Chain의 USDC. Ethereum과 Base의 ETH. 그 밖에 BTC, GRAM, SOL, TRX, BNB, POL, AVAX, LTC, DOGE, XMR을 각자의 네트워크에서 지원합니다. GRAM은 TON의 자체 코인으로, 이전에는 Toncoin으로 불렸습니다.
구매자에게 결제 링크를 보내면 됩니다. 구매자는 마감 전에 아무 지갑에서나 정확한 금액을 결제하고, 서버에는 서명된 웹훅이 도착합니다.
네, 텔레그램 정책 범위 안에서 가능합니다. 실물 상품, 현실 세계의 서비스, 자체 사이트 판매는 일반 봇에서 13개 코인 모두, 미니 앱에서는 TON 기반 GRAM과 USDT를 받을 수 있습니다.
텔레그램 안에서 판매하는 디지털 상품과 서비스에만 필요합니다. 텔레그램이 이런 경우에는 Stars 사용을 요구합니다. 실물 상품, 현실 세계의 서비스, 자체 웹사이트 판매는 Ravelo로 암호화폐를 받을 수 있습니다.
입금으로 인정하기 전에 온체인 기록과 검증된 코인 컨트랙트를 대조해 확인합니다. 가짜 토큰으로 주문이 결제 완료 처리되는 일은 없습니다.
아니요. 12개 네트워크를 모두 저희가 모니터링하고, 결제가 확인되면 서버로 서명된 웹훅을 보냅니다.
아니요. 결제 링크를 만들고 환불이나 출금을 준비할 수는 있지만, 승인은 직접 패스키로만 할 수 있습니다.
확인된 결제 건당 3%입니다. 설정 비용이나 월 이용료는 없습니다. 네트워크 비용은 구매자가 결제하기 전과 출금을 승인하기 전에 표시됩니다.
네, 직접 설정합니다. 출금 건당, 일별, 월별 한도를 정할 수 있습니다. 새 출금 주소는 입금을 받을 수 있게 되기까지 24시간 대기하므로, 로그인 정보가 도용되어도 잔액이 모두 빠져나가지 않습니다.