개발자
암호화폐 결제 API
세 가지 호출만으로 충분합니다: 인보이스 생성, 상태 조회, 잔액 조회. 고객은 결제 페이지에서 결제하고, 여러분은 webhook과 USDT를 받습니다.
엔드포인트
| 메서드 | 설명 |
|---|---|
POST /api/v1/payments | 인보이스를 생성하고 결제 페이지 링크 받기 |
GET /api/v1/payments/{uuid} | 상태, 주소, 트랜잭션 ID |
GET /api/v1/wallet | 사용 가능 및 동결된 USDT 잔액 |
기본 URL: https://api.crybit.net · JSON · 분당 60회 요청 · 인증: X-Public-Key 및 X-Private-Key 헤더.
인보이스 생성
필수 필드는 amount와 currency뿐입니다. 결제를 주문과 매칭하려면 order_id를, 유효 시간을 설정하려면 ttl_minutes를 전달하세요.
curl -X POST https://api.crybit.net/api/v1/payments \
-H "X-Public-Key: pk_…" \
-H "X-Private-Key: sk_…" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"amount":1490,"currency":"RUB","order_id":"ORD-1048","purpose":"Order 1048"}'JavaScript
const invoice = await fetch('https://api.crybit.net/api/v1/payments', {
method: 'POST',
headers: {
'X-Public-Key': 'pk_…',
'X-Private-Key': 'sk_…',
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({ amount: 1490, currency: 'RUB', order_id: 'ORD-1048' }),
}).then((r) => r.json())
location.href = invoice.callback_url // the payment pageWebhook과 위젯
인보이스가 결제되면 CryBit가 가맹점의 webhook URL을 호출하여 주문을 처리할 수 있게 합니다. 고객을 사이트에 머무르게 하려면 confirmation 타입을 embedded로 요청하고 위젯 스크립트로 결제 폼을 여세요.
레퍼런스
FAQ
인증은 어떻게 하나요?
X-Public-Key에 공개 키를, X-Private-Key에 비밀 키를 담아 전송하세요. 두 헤더 모두 필수입니다. 가맹점은 공개 키로 식별되므로 요청에 별도의 상점 ID가 필요하지 않습니다.
테스트 모드가 있나요?
네, 있습니다. 테스트 모드의 가맹점은 테스트 인보이스를 생성하며, 결제 페이지에 결제 완료로 표시하는 버튼이 있고 잔액에는 영향을 주지 않습니다. 실제 결제를 받으려면 가맹점을 실전 모드로 전환하세요.
제한 사항은 무엇인가요?
API는 키당 분당 60회 요청까지 허용합니다. 인보이스 금액은 0.01부터 시작하며, 유효 시간은 5~1440분입니다.