PayTheFlyPro

Generate EIP-712 signed payment and withdrawal links for PayTheFlyPro crypto payment gateway. Supports BSC, Ethereum, and TRON networks.

Security Notice

The signer private key (PTF_SIGNER_KEY) is used ONLY for signing order authorization messages (EIP-712/TIP-712). It does NOT have access to any funds.

Recommendations:

• Generate a dedicated wallet for signing - do NOT use your main wallet
• The signer wallet does not need to hold any funds
• Register the signer address in PayTheFlyPro dashboard as your project's authorized signer

Install Dependencies

npm install ethers tronweb

Create Payment Link

node {baseDir}/scripts/payment.mjs --amount "0.01" --serialNo "ORDER001"
node {baseDir}/scripts/payment.mjs --amount "100" --serialNo "ORDER002" --token "0x55d398326f99059fF775485246999027B3197955"
node {baseDir}/scripts/payment.mjs --amount "50" --serialNo "ORDER003" --redirect "https://mystore.com/success" --brand "MyStore"

Options

• --amount <value>: Payment amount (required)
• --serialNo <value>: Unique order number (required)
• --token <address>: Token contract address (omit for native token)
• --redirect <url>: URL to redirect after payment
• --brand <name>: Custom brand name
• --lang <code>: UI language (en, zh, ko, ja)
• --deadline <hours>: Signature validity hours (default: 24)

Create Withdrawal Link

node {baseDir}/scripts/withdrawal.mjs --amount "100" --serialNo "WD001" --user "0x1234567890123456789012345678901234567890"
node {baseDir}/scripts/withdrawal.mjs --amount "50" --serialNo "WD002" --user "0xabcd..." --token "0x55d398..."

Options

• --amount <value>: Withdrawal amount (required)
• --serialNo <value>: Unique withdrawal number (required)
• --user <address>: Recipient wallet address (required)
• --token <address>: Token contract address (omit for native)
• --redirect <url>: URL to redirect after withdrawal
• --brand <name>: Custom brand name
• --lang <code>: UI language
• --deadline <hours>: Signature validity hours (default: 24)

Query Order Status

node {baseDir}/scripts/query.mjs --type payment --serialNo "ORDER001"
node {baseDir}/scripts/query.mjs --type withdrawal --serialNo "WD001"

Options

• --type <value>: Order type: payment or withdrawal (required)
• --serialNo <value>: Serial number to query (required)

Environment Variables

Variable	Required	Description
PTF_PROJECT_ID	Yes	PayTheFlyPro project identifier
PTF_CONTRACT_ADDRESS	Yes	Project smart contract address
PTF_SIGNER_KEY	Yes	Private key for signing (dedicated wallet, no funds needed)
PTF_CHAIN_ID	Yes	Chain ID (56, 97, 1, tron:mainnet, tron:nile)
PTF_CUSTOM_RPC	No	Custom RPC endpoint

Supported Chains

Chain	chainId	Native Token
BSC Mainnet	56	BNB
BSC Testnet	97	BNB
Ethereum	1	ETH
TRON Mainnet	tron:mainnet	TRX
TRON Nile	tron:nile	TRX

Notes

• Each serial number can only be used once
• Withdrawal signatures expire after deadline (default 24 hours)
• For TRON, addresses use Base58 format (starting with T)
• Native token payments omit the --token parameter