Receipts and errors

Follow the original transaction

AWAITING_TRANSACTION means there is calldata to preview. AWAITING_CONFIRMATIONS means the client should poll the submitted hash with the same signed request. Keep that hash while confirmation is pending.

Our API verifies the transaction, payment, and NFT events before returning a successful PAYMENT-RESPONSE. A confirmed mint returns HTTP 200, MINTED, and the NFT IDs. Signing or broadcasting alone does not confirm a mint.

Continue receipt checks after the phase changes or the authorization expires if the transaction has already been broadcast. If Binance is waiting for App confirmation, track the existing order instead of creating another submission.

Common responses

410 WAITLIST_CLOSED

New registrations and social submissions are closed. Existing on-chain registration records remain readable.

409 MINT_UNAVAILABLE

Check the mint status. Quote requests require an active phase.

409 NOT_ELIGIBLE_FOR_PHASE

Check the signing wallet’s registration and the phase rules.

409 MINT_QUOTE_CHANGED

Fetch a new quote and review it before requesting a new signature.

409 AGENT_ID_REQUIRED

The signing wallet must hold an active Agent ID.

409 MINT_LIMIT_EXCEEDED or INSUFFICIENT_SUPPLY

Report the allowance or supply limit. Do not change the quantity without user approval.

409 AUTHORIZATION_EXPIRED

For an unsubmitted request, obtain a fresh quote and approval. Keep checking the original hash if a transaction was already broadcast.

409 MINT_SIMULATION_FAILED

Stop before submission. Review the authorization and wallet balance; do not bypass the failed simulation.

409 MINT_REVERTED

The transaction reverted and minted no NFT. Report that outcome; do not treat its broadcast hash as a successful mint.

409 PAYMENT_RECOVERY_AVAILABLE

The original order has refundable U. Reconcile any submitted operation first, then preview the returned refund transaction and obtain separate user approval. Verify the refund before requesting a new payment.

409 AUTHORIZATION_UNAVAILABLE

The authorization cannot be reused. Check the original transaction history before requesting a new quote. An unavailable nonce alone does not prove an attack or a successful mint. Do not attempt a refund when the order has no refundable U.

400 INVALID_MINT_AUTHORIZATION

Check the x402 payload encoding and the terms from the original quote.

400 MINT_TRANSACTION_MISMATCH or 409 MINT_RECEIPT_MISMATCH

The transaction or receipt does not match the signed order. Do not report a successful mint or submit a replacement automatically.

429 or 503

Follow Retry-After when present. For confirmation requests, retry with the same transaction hash.

Recovery instructions are included in the English agent guides for minting and marketplace purchases. Refunds use the original payer wallet and application contract; the backend does not sign or submit them.