Skip to main content

Troubleshooting

Common issues and solutions for HashNut integration.

Authentication Issues​

"Invalid signature or credentials"​

Causes:

  • Incorrect apiKey
  • Request body stringified incorrectly
  • Missing required headers

Solutions:

  1. Verify apiKey is correct
  2. Ensure body is stringified exactly as sent
  3. Check all required headers are present
  4. Regenerate API keys if needed

"Invalid accessKeyId"​

Solution: Verify accessKeyId is correct and active.

Order Issues​

"Order not found"​

Causes:

  • Incorrect order IDs
  • Wrong environment (testnet vs production)

Solutions:

  1. Verify payOrderId and merchantOrderId are correct
  2. Check you're using correct environment
  3. Verify accessSign is from order creation

"Duplicate merchantOrderId"​

Causes:

  • Order ID already exists

Solutions:

  1. Use unique order IDs
  2. Check existing orders
  3. Implement idempotency

Payment Issues​

Payment not completing​

Causes:

  • Network congestion
  • Insufficient balance
  • Wrong network

Solutions:

  1. Check transaction on blockchain explorer
  2. Verify customer has sufficient balance
  3. Ensure correct network

Webhook not received​

Causes:

  • Webhook URL not accessible
  • HTTPS not used
  • Firewall blocking

Solutions:

  1. Use HTTPS for webhook URL
  2. Use ngrok for local testing
  3. Check firewall settings

Network Issues​

Wrong network​

Causes:

  • Customer on wrong blockchain

Solutions:

  1. Payment page prompts network switch
  2. Verify order chain matches wallet network

Getting Help​

  • Email: support@hashnut.io
  • Documentation: This site
  • Check Logs: Review request/response logs

Still having issues? Contact Support →