Merchant Onboarding

Step-by-step guide for onboarding a new merchant to the Peak Gateway platform.

1. Create Merchant

1. Sign in to the Admin Portal
2. Navigate to Merchants → Add Merchant
3. Fill in the merchant details:
   • Legal business name
   • DBA (doing-business-as) name
   • Business address and contact info
   • Tax ID / EIN
4. Click Create — a merchant ID is generated

2. Configure TransIT Credentials

Each merchant needs TransIT (TSYS) processor credentials:

1. Open the merchant detail page
2. Go to the Processing tab
3. Enter the TransIT credentials:
   • Device ID — assigned by TransIT
   • Transaction Key — provided during merchant boarding
   • Developer ID — the gateway's developer ID (pre-filled)
4. Save and run a credential validation to verify connectivity

3. Assign Devices

1. In the merchant detail page, go to Devices
2. Click Provision Device
3. Enter the terminal serial number (e.g., Nexgo N86)
4. The device-provisioning service generates activation credentials
5. On the terminal, enter the activation code to pair with the merchant

4. Test Transaction

Before going live:

1. Switch the merchant to test mode in the Processing tab
2. On the terminal, run a test sale for $1.00
3. Verify the transaction appears in Transactions with status APPROVED
4. Check the settlement batch includes the test transaction
5. Switch back to live mode when ready

5. Enable Notifications

1. In merchant settings, enable Email Notifications
2. Add recipient email addresses for:
   • Daily settlement reports
   • Chargeback alerts
   • Account changes

Troubleshooting

Symptom	Likely Cause	Fix
Credential validation fails	Wrong Device ID or Transaction Key	Double-check TransIT boarding paperwork
Device won't activate	Serial number mismatch	Verify S/N on the device label matches portal entry
Test transaction declines	Test mode not enabled	Toggle test mode on in Processing tab
No settlement batch	Batch time not reached	Batches settle daily at the configured cutoff time