TgPay Crypto
Merchant API (개발자용)
Merchant API: 앱, 청구서, 송금, 웹훅.
Merchant API란?
Merchant API는 사업자와 봇을 위한 결제 API예요. 앱을 만들고 API 토큰을 받으면, 내 코드에서 바로 Telegram 사용자에게 청구서를 보내고, 대금을 지급하고, 잔액을 확인할 수 있어요.
개발자로 시작하기
미니 앱에서 앱을 하나 만들고 API 토큰을 한 번 복사해 두면, 바로 API를 부를 수 있어요. 설정은 전부 더보기 → Merchant API에 있어요.
AI 에이전트 연결하기
원격 MCP 서버를 지원하는 AI 코딩 에이전트를 https://app.tgpaycrypto.com/mcp에 연결하세요. API 문서를 읽고 가맹점 앱 생성을 요청하며 웹훅 설정과 연동 코드 작성을 도울 수 있어요. 봇에서 앱 생성을 승인하면 직접 복사하지 않아도 에이전트가 권한 제한 토큰을 받아요. 실제 결제를 받기 전에 완성된 연동을 검토하고 테스트하세요.
청구서로 결제 받기
청구서는 Telegram 사용자에게 대금을 청구하는 방법이에요. API로 하나 만들어 결제할 사람에게 링크를 보내세요. 결제가 성공하면 가맹점 수수료를 뺀 금액이 앱 잔액에 반영돼요.
Merchant API 수수료와 한도
청구서에는 받는 금액에서 떼는 서비스 수수료가 붙고, 송금과 송금 링크에는 금액 한도가 걸려요. 아래 숫자는 지금 설정된 값이지 계약 조건이 아니에요. 앱 화면과 다르면 앱이 맞고, 가장 믿을 만한 근거는 언제나 결제 완료된 본인의 청구서예요.
Merchant API 레퍼런스
모든 메서드가 함께 쓰는 규칙과, 읽기 전용 조회 메서드예요. 메서드별 문서는 청구서와 환불, 송금과 송금 링크, 구독, 웹훅에 있어요.
API 레퍼런스: 청구서와 환불
청구서 메서드는 createInvoice, getInvoices, deleteInvoice, refundInvoice예요. 공통 규칙(인증, 응답 형식, 금액, spend_id)은 Merchant API 레퍼런스에 있고, 흐름을 따라가는 설명은 청구서로 결제 받기에 있어요.
API 레퍼런스: 송금과 송금 링크
대금을 지급하는 메서드예요. 송금은 앱 잔액에서 Telegram 사용자의 지갑으로 자금을 보내거나, 새로 가입할 받는 사람이 봇을 열 때까지 보관해요. 송금 링크는 미리 돈을 채워 두고 받아 가게 하는 링크예요. 공통 규칙(인증, 응답 형식, 금액, spend_id)은 Merchant API 레퍼런스에 있어요.
API 레퍼런스: 구독
Crypto Bot에는 없던 확장 기능, 정기 결제예요. 요금제(금액 + 주기)를 만들어 승인 링크를 사용자에게 보내면, 주기마다 플랫폼이 그 사람의 지갑 잔액에서 결제하고 수수료를 뺀 금액을 앱 잔액에 넣어 줘요. 공통 규칙은 Merchant API 레퍼런스에 있어요.
API 레퍼런스: 웹훅
이벤트가 생기면 웹훅으로 내 서버에 알려 줘요. 더보기 → Merchant API에서 앱의 웹훅 URL (선택)을 지정해 두면, 구독한 이벤트마다 서명된 JSON 본문을 POST해 드려요.
Merchant API 이용약관
이 약관은 Merchant API에 적용돼요. 앱, API 토큰, 청구서, 구독, 송금, 송금 링크, 웹훅, 그리고 AI 에이전트 연결까지 전부요. 앱의 일반 이용약관과 AML 정책에 더해서 적용돼요. 앱을 만들면 이 약관에 동의한 거예요. 2026년 9월 7일 전에 만든 앱을 계속 쓰는 것도 마찬가지예요.
아직 해결되지 않았나요? 고객센터에 문의해 주세요.
Telegram으로 언제든 고객센터에 메시지를 보낼 수 있어요. 고객센터가 PIN이나 이메일로 받은 코드를 묻는 일은 절대 없어요.