Make Your First Test Payment

Before you begin

Make sure you have:

• A 3PAY account

• Access to the sandbox dashboard

  • https://sandbox.3pa-y.com/

• A testnet wallet

• Testnet USDT for the network you plan to test

If you need help generating a testnet wallet or obtaining testnet funds, please contact the 3PAY team.

Sandbox test networks

3PAY sandbox supports the following test networks:

Sandbox transactions use testnet tokens only and do not represent real value.

Step 1: Log in to the sandbox dashboard

1. Go to https://sandbox.3pa-y.com/
2. Log in using your account credentials
3. Confirm you are in the sandbox environment (not live)

All testing must be performed in sandbox before going live.

Step 2: Create a test payment

You can create a test payment using the dashboard or API.

Using the dashboard

1. Navigate to Dashboard

2. Click Create Payment

3. Select:

   • Asset: USDT
   • Network: ERC20 (Sepolia) or TRC20 (Nile)

4. Enter a test amount

5. Generate the payment request

A unique test wallet address will be provided.

Step 3: Send testnet USDT

1. Open your testnet wallet

2. Send testnet USDT to the generated address

3. Ensure:

   • Correct network is selected
   • Correct address is used

⚠️

Sending funds on the wrong network may result in a failed test payment.

Step 4: Wait for confirmation

Once the transaction is broadcasted:

• 3PAY monitors the blockchain
• The payment status updates automatically
• Confirmation time depends on the selected testnet

You will see the payment progress in the sandbox dashboard.

Step 5: Verify the payment status

After confirmation:

• Payment status updates to Completed
• Merchant balance updates accordingly
• The transaction appears in your payment history

If webhooks are configured, a payment event will be sent to your endpoint.

Step 6: Test webhooks (recommended)

To fully validate your integration:

1. Configure a sandbox webhook endpoint

2. Trigger a test payment

3. Verify that:

   • Events are received
   • Signatures are validated
   • Status updates are handled correctly

Webhook configuration must be done separately for sandbox and live.

Common issues & troubleshooting

Payment not detected

• Ensure testnet USDT was used
• Confirm the correct test network

Payment pending

• Testnet congestion may cause delays
• Wait for additional confirmations

No webhook received

• Check webhook URL
• Verify sandbox API keys
• Review webhook logs

Sandbox limitations

Please note:

• Testnet performance may be unstable
• Testnet tokens may be limited
• Sandbox behavior simulates production but may differ slightly
• Sandbox transactions cannot be migrated to live

Moving to live payments

Before going live, ensure that:

• All payment flows were tested successfully

• Webhooks are handled correctly

• Error cases are managed

• KYC / KYB verification is completed

• Live API keys are generated from:

  • https://dashboard.3pa-y.com

Live transactions use real stablecoins on mainnet networks and are irreversible.