Skip to main content

Get API Key

Step 1: Get Your API Credentials​

Request an API key from the administrator:

# Admin creates your API key
curl -X POST https://api.2settle.io/v1/admin/api-keys \
  -H "Authorization: Bearer ADMIN_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantId": "your-company-id",
    "name": "Production Payment API",
    "permissions": ["payment:create", "payment:read"],
    "rateLimitTier": "standard"
  }'

Response:

{
  "status": true,
  "message": "API key created successfully. Save the secretKey - it will not be shown again.",
  "data": {
    "apiKey": {
      "keyId": "pk_abc123...",
      "permissions": ["payment:create", "payment:read"]
    },
    "secretKey": "sk_xyz789..."
  }
}

Important: Save the secretKey immediately - it cannot be retrieved later!