CrptoX API로 첫 테스트 청구서 만들기

TEST 지갑과 키 설정부터 결제 수단 조회, 청구서 생성, 결제 상태 확인까지 CrptoX API로 진행해 보세요.

1. 가맹점 계정 만들기

이메일을 인증하고 샌드박스 모드에서 TRON Shasta 지갑을 활성화한 뒤 TEST API 키를 만드세요. 환경은 키로 결정되며 별도의 테스트 API 주소는 없습니다.

2. 사용 가능한 결제 수단 확인

Bash / cURL BASH
read -r -s -p 'TEST API key: ' CRPTOX_TEST_KEY
printf '\n'

curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer $CRPTOX_TEST_KEY" \
  -H 'Accept: application/json' \
  'https://crptox.com/api/v1/payment-methods'

목록이 비어 있거나 merchant_wallet_unavailable이면 청구서와 같은 환경 및 네트워크에 활성 지갑을 추가하세요. LIVE 지갑은 TEST 키에서 사용할 수 없습니다.

3. 청구서 생성

POST /api/v1/invoices BASH
curl --fail-with-body --silent --show-error \
  -X POST 'https://crptox.com/api/v1/invoices' \
  -H "Authorization: Bearer $CRPTOX_TEST_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{"amount":"1","network":"tron","asset":"USDT","expires_in":1800}'
청구서 만들기

4. 청구서 결제 및 상태 확인

응답의 data.invoice.uuid로 결제 페이지를 열고 청구서를 조회하세요. Shasta에서 테스트 토큰으로 data.payment.amount와 정확히 같은 금액을 보내고 온체인 승인을 기다립니다. 테스트 토큰에는 실제 금전적 가치가 없습니다.

GET /api/v1/invoices/{uuid} BASH
read -r -p 'data.invoice.uuid: ' CRPTOX_INVOICE_UUID
printf '%s\n' "https://crptox.com/pay/$CRPTOX_INVOICE_UUID"

curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer $CRPTOX_TEST_KEY" \
  -H 'Accept: application/json' \
  "https://crptox.com/api/v1/invoices/$CRPTOX_INVOICE_UUID"

data.invoice.status가 paid일 때만 주문을 이행하세요. 감지되었거나 승인 중인 결제는 최종 확정 상태가 아닙니다.

API 키는 서버에 보관하세요. 주문 이행 전에 웹훅 서명을 검증하고 같은 환경의 키로 청구서를 조회해야 합니다. 브라우저 복귀나 결제 화면 캡처는 결제 증거가 아닙니다.

첫 요청이 실패한 경우

  • 401: Bearer 키와 만료 여부, 활성 상태를 확인하세요. 공개 지원 메시지에 키를 올리지 마세요.
  • 목록이 비어 있거나 merchant_wallet_unavailable이면 청구서와 같은 환경 및 네트워크에 활성 지갑을 추가하세요. LIVE 지갑은 TEST 키에서 사용할 수 없습니다.
  • 422: error.details와 지원되는 네트워크 및 토큰 조합을 확인하세요. 할당량 오류는 TEST와 LIVE가 공유하는 구독 한도를 확인해야 합니다. 429는 요청 빈도를 줄이고 안내된 시간 후 재시도하세요.
오류