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では頻度を下げ、指定された時間を空けて再試行してください。