20 posts tagged with "merchant"

Overview​

This guide explains how to use the sub-wallet features of TronLink / MetaMask to manage multiple merchant accounts with 4 mnemonic groups (3 multisig admin groups + 1 treasurer group), each corresponding to 4 master wallets, and complete the following tasks:

• Create sub-wallets for each merchant's multisig admins and treasurer address
• Register a new merchant and configure the multisig admin and treasurer wallets
• Obtain the API Key for integration by the development team

This guide is intended for merchant operations and fund security teams. It covers the full workflow for cold contract replacement, emergency sweep address setup, emergency withdrawal address setup, and high-risk fund handling.

You can execute the process in the following order:

• Replace the cold contract (multisig)
• Set the emergency sweep address (multisig)
• Set the emergency withdrawal address (multisig)
• Sweep and withdraw funds from blacklisted sub-contracts

This document describes how to rapidly batch-create TRON sub-contracts for payment business. The core approach is: first activate TRX currency in the admin console, then generate sub-contract addresses by creating payment orders, and finally deploy the contracts by transferring a small amount of TRX (approximately 1.277 TRX, valued at around 0.5 USDT) to complete batch initialization at minimal cost.

Use Cases​

• Payment business based on the TRON (TRC20) network
• Merchants need to pre-provision large quantities of payment-collection sub-contract wallets to handle high-concurrency payment demands
• Desire to reduce batch sub-contract creation costs by paying gas fees in TRX

1. Introduction to Cross-Chain Bridges​

A cross-chain bridge is a protocol mechanism used to transfer assets between different blockchain networks. Because various public blockchains (such as TRON, Ethereum, BSC, etc.) are independent and use incompatible protocols, assets cannot be transferred directly. Cross-chain bridges enable equivalent circulation of the same asset across different chains through mechanisms like "lock → mint" or "swap → release".

Cross-Chain Capabilities of This Platform​

This admin console already has built-in cross-chain swap functionality, allowing you to complete asset transfers between major blockchains without integrating an external bridge. It works similarly to "currency exchange": select the asset to sell, choose the destination chain for the asset to buy, enter the receiving address on the counterparty chain, and confirm to complete the cross-chain transfer.

A user's sub-contract can sometimes be contaminated by malicious transfers (e.g., receiving blacklisted USDT). If a normal sweep is performed, the blacklisted funds would be transferred into the cold contract, putting the merchant's main funds at risk. To prevent this, merchants should first blacklist the contaminated sub-contract to exclude it from the normal sweep flow, then use the emergency sweep feature to sweep the funds to a safe external address instead of the cold contract, achieving risk isolation.

The steps to use the emergency sweep feature are as follows:

1. Overview​

Tag Address is used to categorize and manage wallet addresses. When creating a payment order, merchants can specify tagId so the system automatically assigns a receiving address from the corresponding tagged address pool.

Address allocation rules:

• If an available address exists under the tag, the system prioritizes reusing it.
• If all addresses under the tag are occupied, the system automatically creates a new address.
• The newly created address is automatically assigned to the same tag.

This mechanism helps merchants achieve:

• Address categorization
• Address reuse
• Automatic address expansion

This mechanism is ideal for merchant scenarios that require managing a large number of receiving addresses.

Documentation Overview​

This guide helps merchant administrators complete the following configurations:

• Enable new blockchain networks (such as ETH, BSC)
• Add new cryptocurrencies (Tokens) on the blockchain

In traditional Web2 internet, when large merchants integrate with payment platforms, they often need to allocate independent payment sub-accounts for different business lines, stores, or even individual users (such as Alipay's PID or bank virtual accounts) to achieve fund allocation management and reconciliation.

In Pay Protocol's blockchain world, the core concept that realizes this functionality is Merchant Sub-Contract. It is not the merchant's sole payment address, but rather smart contract addresses that merchants can generate on-demand in batches, specifically serving particular scenarios (such as one user or one order). Due to its foundation on blockchain and smart contracts, the generation and management methods are more flexible, transparent, and secure.

Blockchain wallets are the "keychains" of the blockchain world, determining how you access and manage assets while impacting security and functionality. Wallet differences can be categorized by usage patterns or underlying protocol models. This article provides a comprehensive understanding of both classification methods, including security recommendations and a comparison table of common wallets.

This article introduces the working principle, security design, and operational flow of the Pay Protocol Signer, aiming to help merchants understand how to achieve high-security on-chain asset management through an "offline signing + on-chain broadcasting separation" model.