Skip to main content

Getting Started — Client Onboarding

This guide walks you through setting up 4pay.online from scratch: from receiving access to processing your first transaction.

Step 1 — Receive your Admin credentials​

After signing a contract, you will receive:

  • Admin Console URL: https://4pay.online/admin_area/signin
  • Initial admin login and password
  • Your organization ID

Log in to the Admin Console and change your password on first login.

Step 2 — Configure your first payment provider​

Before accepting any payments, you need to configure at least one terminal — a connection to a payment provider.

  1. In the Admin Console, go to Terminals → New Terminal
  2. Select a provider from the catalog (e.g., Stripe, Adyen, your local bank)
  3. Enter the required credentials for that provider (API keys, merchant IDs, etc.)
  4. Set the terminal type: payment, payout, or both
  5. Set currencies and geographic scope
  6. Save and activate

See Terminals & Routing for a full guide, and Provider Catalog for required credentials per provider.

Step 3 — Create your first partner (merchant)​

A partner represents one of your merchants — a company or individual that will use your payment service.

  1. Go to Partners → New Partner
  2. Enter the partner's name, login credentials, and contact info
  3. Assign terminals to the partner — they will only be able to route transactions through assigned terminals
  4. Save and activate

The partner will receive an email invitation to access the Partner Area at https://4pay.online/partner_area/signin.

See Managing Partners for advanced partner configuration.

Step 4 — Generate an API key for the partner​

Each partner needs an API key to make API calls.

  1. Go to Partners → [Partner Name] → API Keys
  2. Click Create Key
  3. Share the key with the partner — it is shown only once

The partner uses this key in the x-api-key header for all API requests.

Step 5 — Process the first test transaction​

Ask your partner to run a test transaction using the sandbox API key and a test card. See Sandbox & Testing in the Partner documentation.

Or run a quick API smoke test:

curl -X POST https://4pay.online/api/v1/session \
  -H "Content-Type: application/json" \
  -d '{"login": "your-admin@example.com", "password": "yourpassword"}'

A successful response with a session token confirms your platform is configured and accessible.

Step 6 — Configure routing rules (optional)​

If you have multiple terminals configured, set up smart routing to automatically select the best provider per transaction:

  • Route by currency (e.g., EUR transactions → SEPA provider, USD → US card acquirer)
  • Route by geography (e.g., Asia transactions → local Asian provider)
  • Route by cost (e.g., lowest fee provider first)
  • Failover rules (e.g., if primary provider fails, retry on secondary)

See Terminals & Routing for routing configuration.

Step 7 — Go live​

Before going live:

  • All providers tested with real API credentials (not sandbox)
  • Partner API keys regenerated for production
  • Webhook endpoints deployed and verified
  • Routing rules reviewed and tested
  • Limits and anti-fraud rules configured
  • Admin team accounts created with appropriate roles

Support​