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キーはサーバー側で保管してください。商品の提供前にWebhook署名を検証し、同じ環境のキーで請求書を照会してください。ブラウザーの復帰や支払い画面の画像は支払いの証明にはなりません。

最初のリクエストが失敗した場合

  • 401:Bearerキーの有効期限と有効状態を確認してください。公開のサポートメッセージにキーを記載しないでください。
  • 決済方法が空、またはmerchant_wallet_unavailableの場合、請求書と同じ環境とネットワークでウォレットを有効にしてください。LIVEウォレットはTESTキーでは使用できません。
  • 422:error.detailsと対応するネットワークとトークンの組み合わせを確認してください。枠の不足はTESTとLIVE共通のプラン上限を確認します。429では頻度を下げ、指定された時間を空けて再試行してください。
エラー