Skip to content

Frequently Asked Questions

Find answers to common questions about Nivatio.

General

What is Nivatio?

Nivatio is a blockchain-powered payment platform that enables merchants to accept cryptocurrency payments securely and easily. Our smart contracts handle payment processing on-chain, while our APIs and dashboard provide a seamless merchant experience.

Which cryptocurrencies does Nivatio support?

Currently, Nivatio supports: - NUSD (USD-pegged stablecoin, 6 decimals) - More tokens and chains coming soon!

Is Nivatio open source?

Yes! The core smart contracts and some tools are open source. Check our GitHub.

Integration

How do I get started?

Follow our Quickstart Guide to create your first payment in under 5 minutes.

Do I need to know blockchain development?

No! Nivatio abstracts away the blockchain complexity. You interact with standard REST APIs and redirect customers to our hosted checkout.

Can I embed the checkout in my app?

Yes! Use our JavaScript SDK or React component to embed checkout directly in your app.

How do I receive payment notifications?

Configure a webhook URL in your Dashboard. Nivatio will send events like payment.succeeded to your endpoint. See Webhook Guide.

Payments

What is the difference between NUSD and other tokens?

NUSD is a USD-pegged stablecoin with 6 decimal places. When you charge 100.000 NUSD, the amount in API is 100000.

How long do payments take to confirm?

Environment Confirmations Required Approximate Time
Sandbox 1 ~2 seconds
Production 2 ~30 seconds

Can I refund a payment?

Refunds are currently processed manually via the Dashboard. Automated refunds are coming in v2.

What happens if a payment fails?

You'll receive a payment.failed webhook event. Common reasons: - Customer rejected the transaction - Insufficient NUSD balance - Network congestion

API & Keys

What's the difference between JWT and API keys?

Type Used For How to Get
JWT Dashboard, project management, analytics POST /v1/auth/login
API Key Order creation, retrieval Generate in Dashboard → Project

How often should I rotate API keys?

We recommend rotating API keys every 3-6 months, or immediately if you suspect they're compromised. See API Keys Guide.

My API key stopped working. What happened?

Common reasons: 1. Key was deleted in Dashboard 2. Key permissions were changed 3. Rate limit was exceeded (wait 60 seconds) 4. Using sandbox key in production (or vice versa)

Webhooks

My webhook endpoint isn't receiving events. Why?

Check: 1. URL is HTTPS (required for production) 2. Endpoint is publicly accessible (not localhost) 3. Returns 200 status within 5 seconds 4. No firewall blocking Nivatio's IPs

See Webhook Troubleshooting.

How do I prevent duplicate webhook processing?

Use the eventId field for idempotency:

const processedEvents = new Set();

app.post('/webhook', (req, res) => {
  const event = req.body;

  if (processedEvents.has(event.eventId)) {
    return res.json({ received: true, reason: 'duplicate' });
  }

  // Process event...
  processedEvents.add(event.eventId);
  res.json({ received: true });
});

Can I replay webhook events?

Yes! Go to Dashboard → Project → Webhooks → Click "Replay" on any event.

Testing

How do I get test NUSD tokens?

Use the faucet in Sandbox Dashboard → Test Tokens → NUSD Faucet.

Can I test without real blockchain?

Yes! Our sandbox environment uses a local Anvil node. No real blockchain interaction needed.

How do I simulate a failed payment?

Use the internal API (sandbox only):

curl -X POST https://sandbox.nivat.io/v1/sandbox/simulate-pay \
  -H "x-nivatio-internal-key: YOUR_KEY" \
  -d '{"orderId": "order_123", "outcome": "fail"}'

Billing & Pricing

How much does Nivatio cost?

We're currently in beta. Pricing will be announced before production launch.

Is there a fee per transaction?

Yes, Nivatio charges a small fee (configurable by admin). The fee is deducted from the payment amount before reaching your project wallet.

Security

Is Nivatio secure?

Yes! We use: - Audited smart contracts (see Security Audit) - Secure API authentication (JWT + API keys) - HTTPS everywhere - Rate limiting to prevent abuse

How are private keys handled?

Nivatio never stores your private keys. Wallets interact directly with our smart contracts. We only store public addresses.

What should I do if I suspect a security issue?

Email security@nivat.io immediately. See our Security Policy.

Still Need Help?

Next Steps