Skip to main content

Getting Started

To start using the GOPayments, follow these steps:

1. Create an Account​

Visit the GOPayments website and sign up for an account. Fill in the required information and complete the registration process. Once your account is created, you will have access to the GOPayments dashboard.

2. Add wallet address to withdraw crypto​

After creating your account, you need to add wallet addresses for each supported network before configuring the tokens you want to use.

Step 1: Add Wallet Addresses for Each Network​

GOPayments supports multiple blockchain networks. You need to add a wallet address for each network you plan to use:

  1. Access Wallet Settings

    • Navigate to your dashboard
    • Go to "Settings -> Payment" section
    • Click "Add New Wallet"

  2. Add Wallet Address by Network

    Bitcoin Network:

    • Select "Bitcoin (BTC)" network
    • Enter your Bitcoin wallet address
    • Supports Legacy, SegWit, and Native SegWit formats
    • Example: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa

    Solana Network:

    • Select "Solana (SOL)" network
    • Enter your Solana wallet address (Base58 format)
    • This address will receive SOL and SPL tokens
    • Example: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM

    TON Network:

    • Select "TON" network
    • Enter your TON wallet address
    • Supports TON blockchain addresses
    • Example: EQD0vdSA_NedR9uvnh89rDpemd5yVZ-X2ResS2A6h2X5a5wU

    Arbitrum One Network:

    • Select "Arbitrum One" network
    • Enter your Arbitrum wallet address (Ethereum-compatible, starts with 0x)
    • This address will receive ETH and ERC-20 tokens on Arbitrum
    • Lower gas fees compared to Ethereum mainnet
    • Example: 0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6

    BNB Smart Chain Network:

    • Select "BNB Smart Chain (BSC)" network
    • Enter your BSC wallet address (Ethereum-compatible, starts with 0x)
    • This address will receive BNB and BEP-20 tokens
    • Lower transaction fees and fast confirmations
    • Example: 0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6

  3. Address Verification

    • Double-check your wallet address before saving
    • Ensure the address format matches the selected network
    • Test with a small amount first
    • Keep your private keys secure and never share them

Step 2: Configure Supported Tokens for Each Network​

After adding wallet addresses, configure which tokens you want to support on each network:

  1. Access Token Settings

    • Go to "Settings -> Payments" section in your dashboard
    • Review available tokens for each network

  2. Configure Tokens by Network

    Bitcoin Network Tokens:

    • Native Token: BTC (Bitcoin)

    Solana Network Tokens:

    • Native Token: SOL (Solana)
    • Stablecoins: USDC, USDT (SPL versions)

    TON Network Tokens:

    • Native Token: TON
    • Stablecoins: USDT

    Arbitrum One Network Tokens:

    • Native Token: ETH (Ethereum on Arbitrum)
    • Stablecoins: USDT (BEP-20 versions)

    BNB Smart Chain Network Tokens:

    • Native Token: BNB (Binance Coin)
    • Stablecoins: USDT (BEP-20 versions)

  3. Token Configuration Tips

    • Enable only the tokens you actually need
    • Consider transaction fees for each network
    • Monitor token liquidity and market conditions
    • Set up notifications for token-related activities

Security Best Practices​

  • Use hardware wallets for large amounts
  • Enable 2FA for your GOPayments account
  • Regularly review your withdrawal addresses
  • Keep backup copies of your wallet addresses
  • Test withdrawals with small amounts first

3. Test the API​

After completing your account registration and adding wallet addresses, you can test the GOPayments API using Test Mode before going live.

Access Your API Keys​

  1. Navigate to API Settings

    • Go to your dashboard
    • Navigate to "Settings -> Developers -> API Keys" section
    • You'll find your API keys for both Test Mode and Live Mode

  2. API Key Types

    • Publishable Key: Used for client-side applications (safe to expose)
    • Secret Key: Used for server-side operations (keep confidential)
    • Test Mode Keys: For development and testing
    • Live Mode Keys: For production transactions

API Endpoints​

Production Environment:

  • Base URL: https://api.gopayments.xyz/
  • Description: Live environment for real transactions
  • Use with: Live Mode API keys

Test Environment (Sandbox):

  • Base URL: https://api-sandbox.gopayments.xyz/
  • Description: Sandbox environment for testing
  • Use with: Test Mode API keys

Test Mode Configuration​

Test Mode Features:

  • No real money transactions
  • Simulated payment flows
  • Test all API endpoints safely
  • Validate your integration before going live
  • Use sandbox environment: https://api-sandbox.gopayments.xyz/

Getting Your Test Keys:

  1. In the API Keys section, locate "Test Mode"
  2. Copy your Test Publishable Key
  3. Copy your Test Secret Key
  4. Store them securely in your environment variables

Switching to Live Mode​

When Ready for Production:

  1. Replace test keys with live keys in your environment
  2. Change API base URL from https://api-sandbox.gopayments.xyz/ to https://api.gopayments.xyz/
  3. Update your webhook URLs to production endpoints
  4. Test with small amounts first
  5. Monitor transactions closely
  6. Ensure proper error handling and logging

Important Notes:

  • Test Mode transactions are not real and won't affect your balance
  • Live Mode transactions involve real cryptocurrency
  • Always test thoroughly before switching to live mode
  • Keep your secret keys secure and never expose them in client-side code
  • Use the correct API URL for each environment

Next Steps​

Once you've added wallet addresses and configured supported tokens:

  • Test the setup with a small withdrawal
  • Monitor transaction confirmations
  • Set up notifications for successful withdrawals
  • Review your withdrawal history regularly