자체 봇에서 결제받기
토큰을 받고 코드로 청구서를 만든 뒤 결제마다 웹훅을 처리하세요. 테스트넷에서 출시 전에 전체 결제 흐름을 확인할 수 있어요.
암호화폐 10종 · 네트워크 8개를 하나의 잔액으로 관리 MCP 서버로 AI 에이전트가 연동을 준비해요 →
토큰 받기
봇에서 앱을 만들고 Merchant API 토큰을 받으세요.
청구서 만들기
금액, 코인, 설명을 넣어 API를 호출해요. 웹훅 URL은 앱 설정에서 등록해요.
결제 링크 보여주기
링크나 버튼을 제공하면 Telegram에서 결제해요.
웹훅 처리하기
결제 이벤트를 검증한 후 상품을 전달하거나 서비스 이용 권한을 주세요.
AI 에이전트가 연동을 준비해요
Merchant API는 MCP 서버를 제공해요. 호환되는 에이전트 클라이언트에 연결하면 에이전트가 문서를 읽고, 앱 생성을 요청하고, 웹훅을 설정하고, 연동 코드 작성을 도울 수 있어요. 앱은 Telegram에서 승인하고 결과를 검토한 뒤 테스트하세요.
- 단계 1
에이전트에게 요청 보내기
- 단계 2
Telegram에서 앱 승인
- 단계 3
연동 완료 후 테스트
Connect the MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the Merchant API.
제품에 결제 기능 연결
요청으로 청구서를 만들고 웹훅으로 상태를 받아요. 나머지는 제품에 맞게 구성하세요.
토큰과 테스트넷
별도의 테스트넷 봇 @tgpaycrypto_testnet_bot에서 실제 이용자에게 공개하기 전에 결제 과정을 확인하세요.
코드에서 청구서 관리
HTTP 요청으로 만들고, 취소하고, 상태를 확인해요. SDK는 필수가 아니에요.
정기 결제
이용자가 한 번 동의하면 Merchant API가 일정에 맞춰 구독료를 결제해요.
결제 웹훅
결제 후 이벤트를 보내고 실패하면 다시 시도해요. 수신 쪽에서 서명을 검증하고 중복 처리를 막아야 해요.
문서와 예시
도움말 센터에서 메서드, 오류 코드, 요청 예시를 확인하세요.
암호화폐 10종 · 네트워크 8개를 하나의 잔액으로 관리
GRAM
BTC
ETH
SOL
BNB
LTC
DOGE
TRX
USDTTRC-20 · ERC-20 · BEP-20 · TON · SOL
USDCERC-20 · BEP-20 · SOL
보내기 전 확인과 보호
출금은 외부 주소로 자산을 보내는 기능이에요. 확정 전후에 다음 확인과 보호가 적용돼요.
- 확정 전
- 주소, 네트워크, 메모 확정 전에 받는 사람의 주소, 네트워크, 필요한 메모를 확인하세요. 형식이 올바르더라도 원하는 상대의 주소라는 뜻은 아니에요.
- 저장한 주소 미리 저장한 주소로만 출금하도록 설정할 수 있어요.
- PIN 또는 Face ID 출금할 때마다 PIN이나 PIN으로 등록한 기기의 생체 인증이 필요해요. 세션당 한 번의 확인으로 끝나지 않아요.
- 출금 확정
- 확정 후
- 큰 금액 출금 늦추기 이 보호 기능을 켜면 해당 출금을 보내기 전에 잠시 보류해요. 이 시간에는 취소할 수 있어요.
- 트랜잭션 AML 검사 자산을 보내기 전에 검사해요.
- 출금 알림 설정에 따라 거래 알림을 받아요. 중요한 보안 알림은 항상 보내요.
미리 확인하는 조건
수수료를 포함해 차감할 금액은 확정 전에 표시돼요.
현재 수수료와 최소 금액은 앱에서 확인할 수 있어요.
자주 묻는 질문
지갑, 송금, 결제에 관한 기본 안내예요.
