Developer Platform Setup

This guide will walk you through setting up your Linka Developer Platform account and configuring your API keys.

Prerequisites

Before you begin, make sure you have:

A Linka account (sign up at linka.xyz)
Access to your account dashboard
A secure location to store your API keys

Step 1: Access the Developer Dashboard

Log in to your Linka account
Navigate to the Developer section in your dashboard
Click on API Keys to access your key management

Step 2: Generate API Keys

Production Keys

In the API Keys section, click Create New Key
Give your key a descriptive name (e.g., "Production - Payment Service")
Select the permissions your key needs:
- Read: View transactions and balances
- Write: Create transactions and wallets
- Admin: Full access including account management
Click Generate Key
Important: Copy your API key immediately. You won't be able to view it again.

Sandbox Keys

For testing, use the sandbox environment:

Switch to Sandbox Mode in the dashboard
Follow the same process to generate sandbox API keys
Sandbox keys work identically to production keys but don't process real transactions

Step 3: Configure Your Environment

Store your API keys securely using environment variables:

# Production
LINKA_API_KEY=sk_live_...
LINKA_API_URL=https://api.linka.xyz

# Sandbox
LINKA_API_KEY=sk_test_...
LINKA_API_URL=https://sandbox.linka.xyz

Step 4: Test Your Connection

Make a test API call to verify your setup:

curl https://api.linka.xyz/v1/health \
  -H "Authorization: Bearer $LINKA_API_KEY"

You should receive a 200 OK response with your account information.

Security Best Practices

Never commit API keys to version control
Use environment variables for all API keys
Rotate keys regularly (at least every 90 days)
Use separate keys for different services or environments
Revoke unused keys immediately

Next Steps

Configure Webhooks to receive real-time events
Set up Sandbox Environment for testing
Review Authentication for detailed API authentication