TG Crypto Pay
Merchant API (개발자용)
Merchant API: 앱, 청구서, 송금, webhook.
Merchant API란?
Merchant API는 사업자와 봇을 위한 결제 API예요. 앱을 만들고 API 토큰을 받으면, 내 코드에서 바로 Telegram 사용자에게 청구서를 보내고, 대금을 지급하고, 잔액을 확인할 수 있어요.
개발자로 시작하기
미니 앱에서 앱을 하나 만들고 API 토큰을 한 번 복사해 두면, 바로 API를 부를 수 있어요. 설정은 전부 더보기 → Merchant API에 있어요.
AI 에이전트 연결하기
AI 코딩 에이전트에게 주소 하나(https://crypto.tgpaybot.com/mcp)만 주면 결제 연동을 대신 만들어 줘요. API 문서를 읽고, 가맹점 앱을 만들고, webhook을 붙이고, 코드까지 써요. 새 앱은 봇에서 버튼 하나로 한 번만 승인하면 돼요. 터미널도 필요 없고, API 토큰을 손으로 복사할 일도 없어요.
청구서로 결제 받기
청구서는 Telegram 사용자에게 대금을 청구하는 방법이에요. API로 하나 만들어 결제할 사람에게 링크를 보내면, 상대가 확인을 누르는 순간 앱 잔액으로 들어와요.
Merchant API 수수료와 한도
청구서에는 받는 금액에서 떼는 서비스 수수료가 붙고, 송금과 송금 링크에는 금액 한도가 걸려요. 아래 숫자는 지금 설정된 값이지 계약 조건이 아니에요. 앱 화면과 다르면 앱이 맞고, 가장 믿을 만한 근거는 언제나 내가 받은 청구서예요.
Merchant API 레퍼런스
모든 메서드가 함께 쓰는 규칙과, 읽기 전용 조회 메서드예요. 메서드별 문서는 청구서와 환불, 송금과 송금 링크, 구독, webhook에 있어요.
API 레퍼런스: 청구서와 환불
청구서 메서드는 createInvoice, getInvoices, deleteInvoice, refundInvoice예요. 공통 규칙(인증, 응답 형식, 금액, spend_id)은 Merchant API 레퍼런스에 있고, 흐름을 따라가는 설명은 청구서로 결제 받기에 있어요.
API 레퍼런스: 송금과 송금 링크
대금을 지급하는 메서드예요. 송금은 앱 잔액에서 Telegram 사용자의 지갑으로 바로 보내고, 송금 링크는 미리 돈을 채워 두고 받아 가게 하는 링크예요. 공통 규칙(인증, 응답 형식, 금액, spend_id)은 Merchant API 레퍼런스에 있어요.
API 레퍼런스: 구독
Crypto Bot에는 없던 확장 기능, 정기 결제예요. 요금제(금액 + 주기)를 만들어 승인 링크를 사용자에게 보내면, 주기마다 플랫폼이 그 사람의 지갑 잔액에서 결제하고 수수료를 뺀 금액을 앱 잔액에 넣어 줘요. 공통 규칙은 Merchant API 레퍼런스에 있어요.
API 레퍼런스: webhook
webhook은 이벤트가 생기는 순간 내 서버로 밀어 보내 줘요. 더보기 → Merchant API에서 앱의 Webhook URL을 지정해 두면, 구독한 이벤트마다 서명된 JSON 본문을 POST해 드려요.
아직 해결되지 않았나요? 사람에게 물어보세요.
고객센터는 Telegram에서 24시간 답해 드려요. 고객센터가 PIN이나 이메일로 받은 코드를 묻는 일은 절대 없어요.