📘 Paynch Dashboard

1. Requirements to Use Paynch

Before accessing the dashboard and starting to receive crypto payments, you need to have a few things ready:

1.1 Supported Wallets

2. Connecting Your Wallet

The very first step when opening the dashboard is connecting your wallet. All features require an active wallet connection.

2.1 Language & Theme

The dashboard supports English (EN), Portuguese (PT), and Spanish (ES). Use the language selector in the top-right area to switch. Your preference is saved locally.

There is also a Dark / Light mode toggle button next to the language selector. Theme is saved in your browser for future visits.

3. Overview (Main Dashboard Screen)

After connecting your wallet, the Overview tab loads automatically. It gives you a quick summary of all your payment activity across all deployed contracts.

3.1 Recent Payments Received

Below the statistics, there is a table showing the 5 most recent payments across all your contracts. Each row shows:

• Shortened customer wallet address and payment amount in tokens
• Date and time of the transaction
• Order ID linked to that payment
• Verification code (returned by the smart contract)
• Transaction ID number (#)
• Cashback given to customer (if configured), shown in green

4. My Contracts

This section lists all smart contracts (shops) you have deployed through the Paynch Factory. Each contract is your personal dedicated payment receiver on-chain.

5. Deploying a New Smart Contract

Click the "Deploy New Contract" button in the My Contracts section. A modal window will open with the following fields:

5.1 Fields Explained

5.2 Gas Cost Estimate

Deploying a contract costs gas (paid in BNB). Approximate cost: ~0.01–0.15 USD in BNB at typical gas prices. After deploy, the contract belongs to you forever with no recurring fees (except the 1% per transaction on the free plan).

6. Manage Contracts

This section allows you to interact with any Paynch smart contract directly — view stats, search payments, configure cashback, and run owner-only admin functions.

6.1 How to Load a Contract

Paste a contract address (from "My Contracts" → Copy) into the search box and click Search. The dashboard will load all contract data from the blockchain.

6.2 What You Can See (Anyone)

6.3 Owner-Only Admin Functions

If the connected wallet is the contract owner, an additional admin section appears with the following tools:

• Update Receiver — Change the wallet address that receives payments. Useful if you switch wallets.
• Configure Cashback — Set or change the cashback token address, percentage rate (0–50%), and enable/disable the feature.
• Deposit Cashback Tokens — Add token balance to the contract so it can distribute cashback to customers on future purchases.
• Withdraw Cashback Tokens — Remove unused cashback tokens from the contract back to your wallet.
• Emergency Withdraw — Recover any tokens accidentally sent to the contract that are stuck. Requires token address, destination address, and amount.
• Transfer Ownership — Hand over full admin control of the contract to another wallet address. This is irreversible — use with extreme caution.

7. Payment Button

The Payment Button tab lets you generate a ready-to-paste HTML snippet that adds a full crypto checkout widget to any web page in a single line of code.

7.1 Configuration Fields

7.2 Generating & Using the Code

8. Integrations / API

Paynch operates 100% on-chain and frontend-only — there is no centralized backend, no API keys, and no traditional webhooks. All payment execution happens in the customer's browser via Web3.js.

8.1 Two Integration Options

8.2 Payment Verification API

After a customer pays, verify the payment server-side using this endpoint:

GET https://pay.paynch.app/paynch.php?contract=YOUR_CONTRACT&orderId=YOUR_ORDER_ID

The API returns JSON. Check count > 0 to confirm a successful payment, then validate amountHuman against your expected amount (with a 1.2% tolerance for fees).

8.3 Manual Integration — Required Libraries

For custom integrations, include these scripts before </body>:

<!-- jQuery -->
<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>

<!-- Web3.js -->
<script src="https://unpkg.com/web3@4.0.1/dist/web3.min.js"></script>

<!-- Paynch Script -->
<script type="module" src="https://pay.paynch.app/order/paynch-connect-en.js"></script>

8.4 Required URL Parameters (Manual)

9. Create Your Token Premium Only

The Create Your Token section allows Premium users to deploy their own ERC-20/BEP-20 token directly from the dashboard — no Solidity knowledge required.

9.1 How to Create a Token

10. Plans — Free vs. Premium

10.1 How to Upgrade to Premium

10.2 Using a Coupon Code

If you have a promotional coupon, enter it in the "Have a discount coupon?" field inside the Premium modal before clicking "Buy Now". The price will be recalculated automatically based on the coupon's discount percentage.

11. FAQ — Frequently Asked Questions

Can I use the dashboard without a crypto wallet?

No. All features require a connected wallet because they interact directly with the blockchain. There is no email/password login system. Your wallet is your account.

What happens if I lose access to my wallet?

Paynch has no way to recover your account — we never hold your keys or any account credentials. The contract ownership is tied to your wallet. Use the "Transfer Ownership" function in Manage Contracts to migrate to a new wallet if needed (while you still have access).

Is the 1% fee charged on every payment?

Yes, on the free plan, 1% of every payment processed by your contract goes to the Paynch system wallet automatically. This is handled by the smart contract — you receive 99% directly to your receiver address. Upgrading to Premium removes this fee permanently.

Can I change the receiver wallet after deploy?

Yes. Go to Manage Contracts → search your contract → Update Receiver (owner-only). This requires an on-chain transaction (gas fee in BNB).

Can I have multiple contracts?

Yes. You can deploy as many contracts as you want. Each one is independent with its own payment history, cashback config, and receiver address. Useful for having separate "shops" for different products or stores.

My contract doesn't appear in "My Contracts".

Make sure you're connected with the same wallet that was used when deploying. The dashboard queries the factory contract for shops owned by your current wallet address. If you deployed from a different wallet, switch to that wallet in MetaMask.

The "Connect Wallet" button does nothing on mobile.

On mobile browsers without a built-in crypto wallet, the page will attempt to use WalletConnect (QR code flow). Make sure you have Trust Wallet or another WalletConnect-compatible app installed. Alternatively, use MetaMask Mobile's built-in browser to access the dashboard directly.

What is an Order ID and who generates it?

The Order ID is a unique identifier you assign to each checkout session. Your system must generate it — typically when a user clicks "Buy" and lands on the checkout page. It should be alphanumeric, unique per transaction, and stored in your database. Paynch uses it to link the on-chain payment back to your internal order record.

Is the Premium Plan really lifetime?

Yes. It is a one-time payment. Your wallet address is permanently registered as Premium in the Paynch factory smart contract on BSC. There are no recurring fees, subscriptions, or renewals.

Need more help?

Click "Need help? Use our AI" in the sidebar for instant AI-powered support, or reach out via contact@paynch.io.