Quick Integration Guide

Follow these four steps to seamlessly integrate the BoltUtil crypto payment gateway into your existing business logic.

1

Backend Initiation: Create Order

Backend

Call the /api/v1/order/create endpoint. Our gateway maps your pre-configured recipient address to the specific transaction.

Security Tip: Ensure the X-Bolt-Key and signature are included in the HTTP Header.
2

Frontend Guidance: Payment UI

Frontend

Use the checkoutUrl from the response to redirect users to our minimalist checkout page, or render the QR code directly. Users will transfer funds from their private wallets directly to your exclusive address.

Fully compatible with TRON (TRC20) and mainstream wallets with native App-invocation support.
3

System Push: Listen for Callbacks

Webhook

Our node clusters monitor the blockchain ledger in real-time. Once a transaction confirmation is detected, the system immediately sends a POST request to your notifyUrl with full payment details, including the txHash.

To handle network fluctuations, ensure your endpoint implements idempotency to safely process potential duplicate notifications.
4

Business Delivery: Verify & Fulfill

Backend

Upon receiving the Webhook, verify the data source using our signature algorithm. Once the callback amount is matched against the order, update the system status and complete delivery to the user.

Zero Trust: Never fulfill an order without successful HMAC signature verification and amount matching.