Quickstart

Make a first authenticated Test request, create a Payment Intent, and connect webhook delivery using only contracts implemented by EXZIX.

1. Prepare a Test credential

Create a merchant API key in the Test environment with payment_intents:write and webhooks:read or webhooks:write as required by the operation. The credential is sent as a Bearer token.

2. Create a Test Payment Intent

Use the Test route and an Idempotency-Key. The asset and destination account must belong to the merchant, be active and verified, and be available on an enabled initialized EVM network.

text

curl -X POST https://YOUR_API_HOST/api/v1/sandbox/merchants/YOUR_MERCHANT_ID/payment-intents \
  -H 'Authorization: Bearer YOUR_TEST_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: test-order-001' \
  --data '{"asset_public_id":"asset_YOUR_ASSET","destination_account_public_id":"wa_YOUR_ACCOUNT","amount":"12.50"}'

3. Treat the response as a payment request

The returned status begins as pending. EXZIX supplies the destination, amount, expiry, and hosted payment URL. A browser redirect or merchant-supplied status is not payment evidence.

4. Verify webhook notifications

Configure a Test HTTPS endpoint, preserve the raw request bytes, verify X-Exzix-Signature, then deduplicate by event id before processing. Test simulation produces webhook.test or the selected synthetic payment event; it does not create a blockchain payment.